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Enterprise Edition $995 


NetAdvantage 2003 

with annual subscription $695 


NetAdvantage 2003 
product only $495 


includes COM, .NET & ASP.NET 
product, subscription, as well 
as guaranteed priority support 


includes COM, .NET & ASP.NET 
a year's worth of updates, 
upgrades and new products 
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Infragistics NetAdvantage 2003 Vol. 2 

The Only Integrated Toolset for Presentation Layer Design 



Volume 2 includes New components for 
.NET and ASP.NET along with enhancements 
to existing components: 

NET (Windows Forms) 

• .NET tab & tab strip NEW COMPONENT 

• .NET explorer bar NEW COMPONENT 

• New Office 2003 look and feel 

• .NET toolbar enhancements 

ASP.NET 

• ASP.NET tab enhancements 

• ASP.NET toolbar enhancements 

• ASP.NET listbar/explorer bar new COMPONENT 

• All source code for NET and ASPNET designers and 
components (Subscription and Enterprise Editions) 

• Our ASPNET components deliver thin client deployment 
with rich client interfaces - view or download a 
complete reference implementation with source code at 

www.infraqistics.com/netadvantage/thinreference 

• Licensed per developer (multiple installs for non-concurrent 
use). No runtime or server deployment charges 

• RAD designers maximize productivity, minimize code 

• XP Look and Feel and XP Theme support 
(selected controls) 

• Advanced architecture such as our exclusive 
Presentation Layer Framework 
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Download a free, full-featured trial version! 
Order online, or contact us! 



www.infragistics.com 
800-231-8588 
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Introducing Microsoft Windows Server 2003. Do more with less. 

Microsoft Windows' Server 2003 and the new Visual Studio .NET 2003 provide you with the most productive 
application platform for building, deploying, and managing connected applications. Everything from design through 
deployment is now more efficient. Because the .NET Framework is tightly integrated into both products, you're freed 
from writing plumbing code so you can focus on delivering real business value. You also get simpler and faster 
deployment (thanks to the elimination of DLL version conflicts). Try this new application platform for yourself at 
msdn.microsoft.com/windowsserver2003/tryit Software for the Agile Business. 



The Middleware Company compared the .NET Pet Shop Web application on Windows Se 
scalability of a comparable, optimized J2EE"" application. The .NET connected applicatio 
than 250% faster, 76% less expensive based on price/performance, and required 
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Compuware can help. DevPartner™ Studio tracks underlying 
events and transactions running across multiple tiers and 
environments, for both native Microsoft languages and .NET. 
Working from inside the Visual Studio .NET IDE, DevPartner Studio 
gives you runtime data, down to the spot where the jam occurs. 
You pin down bottlenecks in no time, right at the source. 
Now how's that for taking charge? 

Compuware, a premier Microsoft independent software vendor 
for performance profiling, is offering a free download of 
DevPartner Profiler Community Edition. For information, visit 
offers.compuware.com and enter 3019X31 or call 
1-800-686-6342. 
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■ Automatic runtime error handling 
Distributed monitoring and analysis 
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Build Flexible Uls With Ease 

You can build a robust, intuitive, and reusable user interface 
quickly for any object by taking advantage of the .NET 
Framework's PropertyGrid control. 

by Jonny Anderson 
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Jonny Anderson 
16/02/1968 
1 192, 192, 255 



ColorScherne 

The color scheme this employee has 
selected for their office. 
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Getting Started 

Merge XML Documents 

Find out how to use Extensible Stylesheet 
Language Transformations, VB.NET code, 
and the XMLDocument object to combine 
XML data fdes that originate from multiple 
sources. 

by Kathleen Dollard 
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Desktop Developer 

Create a Custom Ul Value Editor 

A friendly interface is the sign of a well-designed tool. 
Provide users of your controls with a custom UI value 
editor to ease design-time tasks, 
by Bill Storage 
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ASP.NET 

Enable Customer Reviews 

Enhance your e-commerce site by implementing an 
ASP.NET custom control that lets customers review and 
rank products. 
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Q&A 

Manage BLOB Data Fields 

Find out how to retrieve images from a database for random 
display in a picture box, change default WinForms behavior 
with subclassing, and automate asynchronous event publishing. 

by Fabio Claudio Ferracchiati and Juval Lowy 
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Studio Enterprise 

Q Rapidly build cutting-edge Microsoft® Window 
and Web-based applications. 



on vacation. 




.enterprise" 11 & 



Studio for .NET 



Our complete line of eleven enterprise-style 
Windows Forms grid, reporting, charting, data, and 
user interface components for .NET including: 

TrueDBGridfor.NET 

FlexGridfor.NET 

Previewfor.NET 

Reports for .NET 

Chartfor.NET 

DataObjectsfor.NET 

Menus and Toolbars for .NET 

Listfor.NET 

lnputfor.NET 

Zipfor.NET 

Spellfor.NET 

* NEW RELEASES COMING SOON 



StudloforASP.NET 



Six exciting new lightweight and advanced 
grid, reporting, charting, data, user interface, and 
eCommerce components for ASP.NET including: 



WebGridforASP.NET 
WebReportsforASP.NET 
WebChartforASP.NET 
WebDataObjects for ASP.NET 
WebMenus and WebBars for ASP.NET 
PayPal eCommerceforASP.NET 

♦ NEW RELEASES COMING SOON 



( Studio for ActiveX 
Thirteen time-tested and proven grid, 
reporting, charting, data, and user interface 
ActiveX components including: 

True DBGrid Pro 8 
VSFIexGrid Pro 8 
VSVIEW 8 Classic 
VSVIEW 8 Reporting 
Chart 8 
WebChart8 
Query 8 

True DataControl 8 
True DBList Pro 8 
TrueDBInputPro8 
SizerOne 8 
VSSPELL 8 
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_E ANYWHERE 



ComponentOne Studio Enterprise includes ComponentOne Studio" for .NET, ComponentOne Studio" forASP.NET, and ComponentOne Studio" for 
ActiveX. Three revolutionary subscriptions delivering over 100 components for enterprise-style Windows and Web-based application development. 

You also get a one year subscription automatically providingyou with our latest .NET, ASP.NET, and ActiveX* components, new releases, free updates, 
upgrades, and e-mail and online support for one full year. With the most complete set of components available anywhere, you'll have the tools you 
need to develop killer applications-and finally have time for that much deserved vacation. 
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Database Design 

Implement Optimistic 
Concurrency 

Database applications should use 
concurrency checking to prevent one 
user's updates from negating others'. 
Find out how to implement the 
mechanism that best suits your apps. 
by Bob Beauchemin 
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Create Complex Images for 
Small Devices 

Locator+ code: 
VS0308BW T 

Learn how to use a 
sprite — a bitmap 
that contains 
transparent 
information — to 




compose geometric 
shapes with "holes." 
by Bill Wagner 



Rational Straddles 
Java and .NET 

Locator* code: EA0301JF_T 

Mike Devlin, general 
manager of IBM Software 
Group's Rational 
Software division and 
formerly a cofounder and 
CEO of Rational 
Software, discusses how 
IBM's acquisition will 
impact Rational's 
direction, the future of enterprise-level 
development, Java, and .NET. 
by Jim Fawcette 



Enforce Constness With C# 

Locator* code: VS0308WG T 

Unfortunately, C# doesn't have the 
const keyword. Learn to fake it in three 
steps by using interfaces, 
by Bill Wagner 

Prevent ADO.NET 
Transaction Errors 

Locator* code: VS0308RR T 

In some cases, your app might throw an 
unhandled error and crash even though 
your code implements an error handler. 
Learn how to handle an unexpected 
ADO.NET exception in your code, 
by Roman Rehak 





More Than 400 .NET Books 

FTPOnline presents every .NET book we 
could find — more than 400 books from 
almost two dozen publishers, about 
everything from AD0.NET to C#to XML 

Browse or search the list at 
www.ftponline.com/books/ 
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wireless, Web services, and XML. Sign up for free at www.visualstudiomagazine.com. 
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Type in this Locator* code to download the 
code for this particular article. You can 
also get the code for this article by pulling 
up the article itself, then clicking on the 
link to the accompanying code. 

Type in this Locator* code to discuss this 
article with the author and other readers in 
VSM's online discussion forums. 

This Locator* code brings up the article 
itself, along with any code listings, 
sidebars, and other extra content that 
wouldn't fit in the printed edition of the 
magazine. 

This Locator* code brings up a past article 
on a related topic. 
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Download 

VS0308JA Download the code for this article, 
which includes C# and VB.NET versions of a 
demo application that demonstrates basic 
use of the PropertyGrid control and 
implementation of custom property editors to 
generate a rich Ul for a custom-built 
document object model. 

Discuss 

VS0308JA_D Discuss this article in the .NET 
Framework/IDE forum. 

Read More 

VS0308JA_T Read this article online. It 
includes Listing 4. 
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.NET Puts Emphasis 
on Development 



Once upon a time, the .NET moniker was ubiquitous at 
Microsoft. Microsoft branded everything from its core 
development tool (Visual Studio .NET) to its next- 
generation server platform (Windows Server .NET) to its wide- 
ranging enterprise app servers (.NET Enterprise Servers) with the 
.NET label. 

Despite — or more likely, because of — the ubiquity of the 
.NET brand name, it was difficult to get a firm handle on what 
exactly .NET was. Gates himself acknowledged as much, assert- 
ing that perhaps Microsoft had been too enthusiastic in applying 
the .NET branding to its various products, thus confusing the 
market about what exactly .NET is. Shortly afterward, Microsoft 
indicated that it was dropping the .NET tag from its then about- 
to-be-released version of Windows Server. Its new name: Win- 
dows Server 2003. More recently, Microsoft noted it would be 
renaming its .NET Enterprise Servers group that includes Com- 
merce Server, BizTalk Server, and Content Management Server 
to the Windows Server System. Windows Server 2003 and the 
Windows Server System products will carry the badge of being 
".NET Connected," but all that remains of the .NET brand be- 
yond the .NET Framework (itself to be subsumed into Win- 
dows) these days is Visual Studio .NET. 

The net effect of these changes means that .NET is now being 
marketed squarely to developers. It doesn't so much mark a re- 
trenchment from .NET as a clarification of who .NET is for. It 
also marks a return to emphasizing the importance of Windows 
to Microsoft's overall vision. Not so long ago, people were speak- 
ing of .NET as the future platform, and had visions of a portable 
VM that could be adapted to other operating systems such as 
Linux. Microsoft now asserts that the .NET Framework is part of 
Windows — period. 

This confusion about what .NET is and does is evident in the 
handful of commercials for .NET, which feature the tagline, "six 
degrees of separation." 

Microsoft's .NET commercials trumpet how .NET enables 
you to have a more dynamic relationship with your customer, 
but they often have the unintended side effect of making you 
wonder what business value .NET provides you. In one commer- 
cial, a salesman is seen discussing an exotic car's color with a po- 
tential customer. The customer waffles on his color choices, and 
the commercial cuts back and forth from the conversation be- 
tween the customer and salesperson to the factory where the car 
is being repainted several times depending on the client's current 
color preference. The commercial does a decent job of suggesting 



that .NET makes you responsive 
to your customer needs, but to 
what end? All that wasted paint 
cannot be good for the bottom 
line. The architecture that .NET 
made possible in this case might 
be responsive, but it will also 
make you broke. That's not a 
quality many businesses are look- 
ing for in their enterprise soft- 
ware. What exactly is this com- 
mercial trying to tell people? 

It's interesting to me that 
Microsoft has struggled in defin- 
ing its overarching vision because 
I think its fundamental strategy is 
sound for today's business envi- 
ronment. Mike Devlin, general 
manager of Rational Software at 
IBM, indicated in a recent inter- 
view with Jim Fawcette that 
today's businesses aren't choosing 




How do you feel about Micro- 
soft's decision to scale back 
the use of its .NET branding? 
Tell me at ednote@fawcette. 
com or discuss this in the Talk 
to the Editors of Visual Studio 
Magazine forum on our Web 
site. Use this Locator+ code: 
VS0308EN_D 



between .NET and J2EE tech- 
nologies; they are choosing to work with both and to integrate 
their strengths as well as they can (check out the interview at 
www.ftponline.com/ resources/interviews/ devlin/) . 

That wouldn't seem to favor a company as fiercely partisan to 
its own technologies as Microsoft is, but its standards-based ap- 
proach to SOAP, XML, and Web services leave Microsoft well 
situated to play in this new environment. For today's companies, 
the most compelling issues aren't Java vs. .NET, or Sun vs. 
Microsoft, but how to best leverage the systems they have, what- 
ever they might be. SOAP and Web services are a major part of 
this integration for all the big vendors, and Microsoft's develop- 
ment tools and architecture for creating and integrating Web ser- 
vices are as strong or stronger than anyone else's. 

The .NET vision of enabling you to connect to information 
anywhere, anytime, on any given device remains a core part of 
Microsoft's development tools strategy, notwithstanding the re- 
cent changes in nomenclature. Your customers don't really care 
about .NET or which servers carry the .NET brand, per se, but 
about what value you can provide them. None of the waffling on 
branding changes what VS.NET and the .NET Framework 
within the Windows Server System enable you to deliver, vsm 



VISUAL StUDIO MAGAZINE 



AUGUSt 2003 



www.visui 



magazine.com 



Learn to Build .NET 






Orlando 

Sept. 8-13, 2003 



Are you supporting legacy apps using legacy tools, 
or developing powerful new distributed apps 
using .NET tools and technologies? 



Attend VSLive! and move ahead with .NET. Whether you are interested in 
rich client or server-based development, you will learn about the specific 
areas you need to build your .NET development skills. And you'll find 
^ "Black Belt" sessions that deliver more advanced topics that fit your 
experience. 

• Save Yourself with .NET Serialization 

• Design Highly Scalable Distributed .NET Apps 

• Master Remoting and Reflection with C# 

• Create Custom Server Controls in ASP.NET 
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.NET Security Techniques asp 
Juval Lowy, IDesign ^ 

.NET allows you to configure permissions for 
components, and provide evidence to prove that it 
has the right credentials to access a resource or 
perform some sensitive work. We'll show you how to manage 
application security using the .NET admin tool and how to do so 
programmatically. We'll also discuss .NET's way of dealing with 
what users are allowed to do using .NET role-based security. 




ADO .NET and XML 

Andrew Brust, Progressive Systems Consulting 

ADO .NET, rather than merely offering the ability to 
persist to an XML file, actually uses XML as the native 
format for representing its multi-table Datasets. Well 
look at how the ADO .NET objects map to various elements in the 
Dataset's XML schema and how to use XML from any platform to 
create, read, and modify ADO .NET Datasets. 
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Top Ten Gotchas for Visual Basic .NET 
Todd Kimble, Microsoft 

Visual Basic .NET is the biggest upgrade since VB 4 
was introduced — maybe the biggest ever. With it, 
developers have a new tool that makes it easier than 
ever to build great applications. But not everything in Visual 
Basic .NET is simple to use. Come join us for a thorough examina- 
tion of the ten most common stumbling blocks developers 
encounter when moving to Visual Basic .NET, and make your 
migration easy. 




I Advanced Web Services Development ess* 
T<* M Aaron Skonnard, DevelopMentor ^ 

" JjF Although ASP.NET WebMethods support the 
JF* baseline Web service specifications, there are still 
>- 1 many open issues that must be addressed in order to 
build successful distributed systems. We'll discuss how to maxi- 
mize and extend ASP.NET's Web services framework through 
SoapExtension classes. We'll also introduce you to Microsoft's GXA 
specifications that address such concerns (e.g., WS-Security, WS- 
Routing, DIME, etc.) and we'll show you how to begin working 
with these new layers through Microsoft's recently released Web 
services enhancements for Microsoft .NET. 



Design Highly Scalable 
Distributed Apps with .NET 
Rockford Lhotka, Magenic Technologies 

The Microsoft .NET Framework provides extensive 
support for creating highly scalable distributed 
applications. Attend this session and you will learn how to design 
Windows and Web-based applications based on distributed business 
objects, achieving high levels of reuse, scalability, long-term 
maintainability and other benefits. You will also learn how Web 
services, Remoting, object serialization, Enterprise Services, 
autodeployment and other .NET technologies come together to 
create these applications. 
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Tracing and Debugging in ASP.NET 
Dave C. Bost, Solution Partners, Inc. 

Attend this session and you'll learn about the new 
tracing facilities in ASP.NET. Youll also see a demon- 
stration of how to track the execution path of an 
ASP.NET application and interpret the results. Included will be 
demonstrations highlighting the usage of Page-level tracing and 
Application-level tracing and interpreting the output of the tracing 
logs, plus youll also see how to create your own trace listeners to 
capture your trace messages. 



Call Today 



> for Details! 800-848-5523 



www.vslive.com/orlando 

Microsoft, MS, MSDN, SQL Server, Visual Basic, Visual C++, Cft, Visual Studio and Windows are registered trademarks of Microsoft Corporation. VSLive! and Visual Studio Maga^., 
registered trademarks of Fawcette Technical Publications, Inc. Visual Studio is used by Fawcette Technical Publications, Inc. under license from Microsoft. 

All other trademarks are property of their respective owners. 
Sessions highlighted are part of the VSLive! 2003 line up. Exact sessions and speakers may change for New York schedule. Check www. vslive.com/ny for details. 



Letters to Visual Studio Magazine are 
welcome. Letters must include your 
name, address, and daytime phone num- 
ber to be considered for publication. Let- 
ters might be edited for form, fit, and 
style. Please send them to Letters to the 
Editor, c/o Visual Studio Magazine, 913 
Emerson St., Palo Alto, CA 94301; fax 
them to 650-853-0230; or e-mail them to 
vsmedit@fawcette.com. 

High Cost Cause for Piracy 

I just wanted to point to another aspect of the 
software piracy issue — cost [Editor's Note, 
"Software Piracy is Everyone's Responsibil- 
ity," by Patrick Meader, June 2003]. I don't 
condone piracy, and my company is going to 
great lengths to make sure that anything we 
use or install has a license. But to the common 
man and some corporations, the current cost 
of software is becoming outrageous: $40,000 
for SQL Server, $6,000 for spam control, and 
so on. I write software for my company, and 
I think the prices charged for software are 
getting out of hand. 

The government has regulated utilities, 
phone, and cable service. Is software next? 
Why not? It's just as out of hand as those 
were. I believe in paying people what they are 
worth, but there has to be a limit to how far 
and how much. With Microsoft Office run- 
ning $400 to $500 per license, is that not a 
possible reason for piracy? People can't afford 
it, so they steal it! I'm not saying I agree, but 
I can see where people could feel that way. I 
think that is why there has been an upturn 
with Linux. It isn't as expensive, and it's 
working toward competing with Microsoft. 

James Newman, received by e-mail 

VB.NET Fans Speak Up 

The writer of.NET Not Living Up to VB6 
Days" is clearly in denial [Letters to the 
Editor, June 2003]. VB6 is on the way out. 
It's time to move on. 

I'm sorry, but if you don't understand 
.NET, then you should take this as a wake-up 
call that you have a lot to learn about modern 
software development. The language enhance- 
ments in VB.NET are great, but in reality, 
they are expected of a modern programming 
language. I don't view parameterized con- 
structors as "powerful" — I expectthem. Same 
goes for structured exception handling. I'm 
glad to forget about all the clunky things we 
did in VB6 to make it work somewhat like a 
modern language. VB.NE1 increases one's 
ability to create reusable code, and this makes 
it more productive in my opinion. 

VB.NET has shown us that a lot of 



people need to hit the books and learn about 
modern programming practices. This is the 
wrong career for those with an aversion to 
learning new things. 

Luke Ferris, Tucson, Ariz. 

After more than 30 years of never having to 
write to the editor, Rob Hermans' letter got 
me riled up enough. I've been in the IT 
industry since 1 970 (has it really been that 
long?). I've been working with PCs since 
1991, and have not been this excited about 
slinging code in a very long time. 

I just finished a Web site that included 
several Web pages, VB.NET components, 
and many stored procedures, and could not 
have come anywhere near my deadline with- 
out .NET. I was able to write the Web pages, 
the VB components, and the stored proce- 
dures without having to open up any other 
tool. I was even able to save considerable time 
by using interop to run an already existing 
COM component. I never had to open 
InterDev or SQL Server— just VS.NET. I'll 
take that productivity over the VB6 world 
anytime. And just think, not once during the 
whole process did I ever have to open up or 
run RegEdit! 

If you really do have any hope of "getting 
back on the VB bandwagon," you really 
need to get off your high horse and read past 
the editorials of VSM, get yourself some 
.NET training, and read some .NET books. 
And if you really insist on staying with VB6, 
I have some books you can buy! 

Rich Sabo, Marietta, Ga. 

Go Online! 

Use these Locator+ codes at 

www.visualstudiomagazine.com 

to go directly to these related resources. 

Download 

VS0308: All the listings and code files for the 
August 2003 issue of VSM 'm one ZIP file 
VS0308JA: "Build Flexible Uls With Ease": 
C# and VB.NET versions of a demo app 
VS0308GS: Getting Started: a simple 
WinForms interface that lets you extract 
information from Northwind, preprocess it 
with XSLT, and perform an intimate merge 
VS03080T: Desktop Developer: the 
ImageButton control, its design-time editor 
code, and a sample client window 
VS0308QA: Q&A: applications that 
demonstrate subclassing with VB.NET and 
asynchronous event publishing 

VS0308AN: ASP.NET: the ReviewCtrl custom 
control 

VS0308DD: Database Design: examples of 
using the AD0.NET DataSet and optimistic 
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Add Tel net to Your 
.NET Apps 

PowerTCP Telnet for .NET from Dart Communications lets 
you add streaming Telnet functionality easily to your .NET 
apps. You can drop a Telnet control onto a VS.NET design surface 
to instantiate a ready-to-use, module-scoped object in your code 
immediately. If you prefer, you can set a reference to the control's 
assembly and hand-code your instantiation. This approach gives 
you total control over object scope, creation, and lifetime, but 
requires you to add a licenses.licx file to your project and code event 
handlers manually. 

The product supports both synchronous and asynchronous 
modes. Synchronous operation addresses most typical require- 
ments. You invoke the Receive method to block execution until a 
server response is received. Setting the DoEvents property allows 
your app to process other events while execution is blocked, so you 

PowerTCP Telnet for .NET 

Dart Communications 

Web: www.dart.com/dotnet/telnet.asp 

Phone:315-339-8040 

Price: $349 

Quick Facts: A set of controls for implementing Telnet and remote access 

protocols in .NET applications. 

Pros: Easy to use; powerful; many features. 



From Dart Communications, Inc. 

Firewall Address: |63.47.48.1 
Password: ******* 



Get Firmware Version 
via Telnet 

QscoTlX FirewaTversion6.2(2) ~ 
Cisco PIX Device Manager Version 1 . 1(2) 



Talk Telnet. This application uses PowerTCP Telnet for .NET to 
connect to a Cisco PIX Firewall and obtain its firmware version for 
display. The app took less than 10 minutes to write. 

don't need to resort to asynchronous mode to handle them. 

Asynchronous operation runs in the background. Invoking the 
BeginReceive method spawns a worker thread and causes your app to 
continue while the server response arrives in parallel execution. The 
worker thread raises the EndReceive event when it's done, so your app 
can handle the success or failure of the operation accordingly. 

Other useful features include a Login method that encapsulates 
an entire server login conversation, a WaitFor method for easy 
scripting, automatic option negotiation (you can disable this if 
necessary) , and a Tel netStream class that extends the generic Stream 
class by performing Telnet-specific formatting of data passing 
through the stream. 

Much of the Telnet control's functionality derives from a base 
TCP class. This thoughtful design results in consistent operation 



Store and Share Code 



Code reuse is the holy grail of software development, and .NET's 
robust support for object-oriented programming lets you 
leverage existing code effectively. It would be great to have a way to 
save the code snippets you don't need right now but might later in 
the project, or to store cool code you find online for future use. 
VB2TheMax's CodeBox for .NET might be the answer. 

CodeBox is a standalone tool for storing, accessing, and docu- 
menting categorized code, making it easy to share the repository 
with other developers. You can store code snippets in VB.NET and/ 
or C#; save entire modules; include notes about the code; and attach 
files, such as Word documents and ZIP files. You can bookmark any 
code items — without adding them to your Internet Explorer favor- 
ites list — and perform flexible searches for code. 

The repository can be an Access file, SQL Server database, or any 
other database you can access with OLE DB, although CodeBox is 
integrated most closely with Access. It provides an update feature 



iOMtpAur>>U-4.l!><(.ou4TlUy (of .Nt )\1 tfirork-sVf.wMtfixl iti.mdb 



udeBox for .NET 
VB2TheMax 

Web: www.vb2themax.com 
Price: $79 for Pro version, $159 for Enterprise version 
Quick Facts: Handy code repository with rich features for storing, document- 
ing, and finding code. 

Pros: Effective Ul; export to HTML; can use almost any data store. 
Cons: Minor limitations on some features. 
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Build a Code Repository. The CodeBox interface exposes a surprising 
number of features in a clean interface. You can search for code using 
any text, filter for a particular category, limit the search to certain fields, 
and apply other filters. 

that lets you download new or updated code that the VB2TheMax 
team publishes. You can merge code from multiple CodeBox 
repositories, but the product doesn't filter duplicate code. 

One of CodeBox's nicest features is that you can export an item 
to an HTML page, complete with the VB.NET and C# code, 
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Looks 



Add Telnet to Your .NET Apps 

and behavior across other Dart communica- 
tion controls that also inherit from TCP. 

Three other controls — Rexec, Rlogin, 
and Rsh — provide the remote login, execu- 
tion, and shell protocols that Unix hosts 
typically support. These controls are ex- 
tremely easy to use with a single method call. 
They too support asynchronous mode. 



The online help is clear and thorough. 
Concise code samples in VB.NET and C# 
show how to perform most common tasks. 
Unfortunately, the sample code refers to 
classes in the Dart namespace without men- 
tioning or including an appropriate Imports 
statement. The code works only if you add 
the Imports statement, or if you prefix the 
class names in the code with a fully qualified 
namespace. Otherwise, the documentation 




Is your Imaging Toolkit 
powerful enough to 
do the job? 

(Ours is.) 



J20031 

kMertl Award J 



IMRGXPRESS 

ImagXpress delivers the most advanced .NET, COM and RctiveX 
imaging toolkit with the fastest processing speeds available. 

Build powerful applications with image viewing, editing, printing, 
advanced TWRIN scanning, fully programmable annotations, 
multi-page TIFF, file format conversions, video capture, and 

Select from a full suite of image processing functions 
(including deskew, despeckle, autocrop), and support for 
over 3D file formats including JPEG 20Q0.. 

Contact sales@jpg.com to access customer-acclaimed suppor 



-FEATURED TRIRL VERSIONS 
RVRILRBLE FOR IMMEDIRTE DOWNLORD 



RLSO RVRILRBLE 



SMRRTSCRN xpress brrcode- 
High-Speed Barcode Recognition Toolkit 

SMRRTSCRN XPRESS ICR/OCR/fJMR/MI 
Character and Mark Recognition Toolkit 

SCRNXPRESS ISIS - 

Control High-Speed ISIS* Scanners 




NET, COM, C+ + 
VCL, RCTIVEX 



and code samples are well-written and easy 
to follow. You'll also find working demos 
for all four controls in VB.NET and C#, and 
an ASP.NET demo that requires additional 
setup in Internet Information Services. 

PowerTCP Telnet for .NET is an excel- 
lent product that deserves a place in any 
serious developer's toolbox. \ 



Leonard Lobel is the CEO and founder of 
Sleek Technologies, a development shop 
specializing in Microsoft-based solutions, and 
the director of software for Government Data 
Publications in New York. Lenni is also a 
consultant and trainer with more than 24 
years of experience. Reach him at llobel® 
sleektechnologies.com. 

Store and Share Code 

examples, notes, and dependencies. This 
has some interesting possibilities for docu- 
mentation, although this version of CodeBox 
can export only one item at a time. It would 
be nice to export an entire category at once, 
at the least. 

You'll probably find lots of good uses for 
CodeBox. I used to think of its class of tools 
as a way to store my own code snippets along 
with any the product provides. CodeBox is 
even more versatile. It lets you store useful 
code and other files you get from magazines 
and online sources. You might not have an 
immediate use for these items, but you know 
where to find them when you need them. 

I'd love to see a few additional features in 
CodeBox. The UI doesn't have a way to 
create a new SQL Server-based repository. 
You can get the SQL script files to do this, 
but it really should be automated. Also, 
exporting all code items to a Web site would 
be a great way to enable documentation and 
use of the code. 

Nevertheless, CodeBox is a well-designed 
and well-implemented utility you'll find more 
uses for every day. An enterprise version 
comes with 20 licenses and the .NET source 
code, all for only twice the cost of the single- 
license, standalone version. With the source 
code, you can modify CodeBox and even set 
up a service to distribute code updates inter- 
nally in your organization, vsm 

Don Kiely is a senior technology consultant. 
When he isn't writing software, he's writing 
about it, speaking about it at conferences, 
and training developers in it. Reach him at 
donkiely@computer.org. 




PEGASUS IMAGING CORPORATION 

THE LERDER IN DIGITAL IMAGING 

www.pBga5u5imaging.com on call 1.80.0,. 875. 7009 
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Architect 



Resort and Spa 
Palm Springs, 
California 




October 12-14, 2003 




Learn Best Practices 



from The Best Sources 



Attend Enterprise Architect Summit and be a part of 

conference focused on IT professionals tasked with inte 
with business demands, to create real-world architec 

Keynotes, General Sessions and Technical 
Meetings that Address 

• Service-Oriented Architectur 

• Architectural Case Studies a 
Best Practices 

• Integration Best Practices 

• Security Technology Overviews and 
Roadmaps 

• Legacy System Migration 

• Recommendations and Reports from 
Analysts on Deciphering Standards an 




www.enterprise-architect.net/summit 

Call 800-848-5523 (or 650-833-7100) for details. 



Enterprise 

Architect 

Summit BUS 




Best Practices from the Best Sources 





Westin Mission Hills 
Resort and Spa 
Palm Springs, 
California 



Enterprise 

Architect 



Summit 



2003 



As your technical business requirements change, 
so does your need to manage and coordinate 
multiple silos of information and experience across the 
Enterprise. Attend Enterprise Architect Summit and be 
a part of the first-and only-conference focused on IT 
professionals tasked with integrating emerging 
technologies with business dynamics to create 
real-world architectural solutions. This technical 
interchange has been specifically designed for Chief 
architects, strategic architects, network architects, software architects, 
and systems analysts dealing with enterprise-level issues. 

Content 

You'll be a part of discussions with experts on strategic best practices for 
service-oriented architecture, pervasive wireless apps within the 
Enterprise, and real-time Business Process Management. Our technical 
drilldowns will bring you up to speed on transforming IT from cost center 
to revenue generator: Learn about managing identity in the virtual 
enterprise, making the most of open source and open standards, and 
best practices in security, storage, and scalability. 

Networking 

We know that networking with your peers is as important as the 
presentations, so you'll find golf, tennis and birds-of-a-feather meetings 
to facilitate interaction. And, because this is an intimate, focused event 
that will catalyze interaction with the speakers and audience, we are 
restricting attendance to only the most qualified audience. 

This is a unique event-one not to be missed-and I look forward to seeing 
you in Palm Springs, 



October 12-14 





Steve Gillmor 

Enterprise Architect Summit Editorial Chair 




Championship Golf Courses 

Just a short drive from downtown 
Palm Springs, the Westin Mission 
Hills Resort was named one of the 
top 75 golf resorts in the U.S. by 
Golf Digest magazine. Superb golf is 
available at two championship 
courses, and can be part of your 
experience as an Enterprise Architect 
attendee. Join your fellow attendees, 
sponsors and speakers during the 
pre-event golf tournament on Sunday, 
October 12. 




Welcome Reception 

Unwind from your trip into Palm 
Springs, or relax after a day out 
on the golf course. The Enterprise 
Architect Summit starts with an 
evening of cocktails and hors 
d'oeuvres and prime networking 
opportunities for all Summit 
participants. 





Sponsor and 
Exhibitor Pavilion 

There is much more to the 
Enterprise Architect Summit 
than conference sessions. 
All attendees are invited to 
participate in live demos and 
networking opportunities with 
the Summit sponsors and 
exhibitors throughout the event. 



Register by September 3rd SAVE $100 



Enterprise 

Architect 



Summit 



2003 



Palm Springs, California • October 12-1 4 



Learn Best Practices 

For Technology Solutions 

That Meet Your Business Goals 

The Enterprise Architect Summit will offer the best networking, support and information designed for solutions . You'll 
learn best ways to manage multiple technical departments, ensuring that all the systems work well together. Our 
industry leaders will give you best strategies for taking advantage of new technology and integrating legacy systems. 
And, you'll gain loads of tips that will keep your technology's performance true to your enterprise's mission and 
competitive position within the marketplace. 



Monday, October 13 Tuesday, October 14 



9 a.m. 


Keynote 




9 a.m. 


Keynote 






Strategy 


Technology 




Strategy 


Technology 


10:45 a.m. 


Whiteboard: 
Migration to the 
Service-Oriented 
Architecture 


Grid Computing 

The Autonomic Enterprise 


10:45 a.m. 


Web Services Interoperability: 
Open Standards in a 
Market-Driven Economy 


Enterprise Integration 
Frameworks: App Servers 
Meet the Enterprise 
Service Bus 


12:15 p.m. 


General Session and Lunch 




12:15 p.m. 


General Session and Lunch 




1:45 p.m. 


Best Practice: 
Real Time Computing 
Meets Business Process 
Management 


Web Services Security: 
The Virtual Enterprise 


1:45 p.m. 


Economics of Open 
Source: How Much 
Does "Free" Cost? 


Orchestration Standards: 
The Ground War Begins 


3:30 p.m. 


Wireless Enterprise: 
Making the Most 
of Pervasive Apps 


Schemas in the Wild: 

XML Takes on 

the Vertical Industries 


3:30 p.m. 


From ERP to Enterprise 
Architecture: Immediate 
and Future R0I 


Patterns and 
Antipatterns: Reusability 
Hits Prime Time 


5 p.m. 


Consolidation and 
Collaboration: From Server 
Utilization to Application 
Development Productivity 


Structured vs. Unstructured: 
Managing Storage 
Across the Great Divide 


5 p.m. 


Best Practice: 
Life-Cycle Application 
Automation 


Long-Running Transactions 
Mapping Conversations 
in the Asynchronous 
Enterprise 





Beautiful Palm Desert and Westin Mission Hills Resort and Spa 

All attendees at the Enterprise Architect Summit are invited to stay at the Westin Mission Hills Resort and Spa. 
Enjoy all the comforts of this luxury resort, and be conveniently close to all Summit activities. Attendees will 
receive the nightly room rate of $149. 

eserve your room, please call the hotel directly at (760) 328-5955 and mention that you are an attendee of Enterprise Architect 
imit presented by Fawcette Technical Publications, Inc. 



Call 800-848-5523 or visit www.enterprise-architect.net/summit 



Enterprise Don » t wajt — register now and maximize your savings 

ArCnlt6Ct wnen y° u use tnis registration form 

Summit WlTllCj and priority code: PALMS. 



Ways To Register 

FAX: 650-321-3818— Send This Form! 
PHONE: 800-848-5523 (or 650-833-7100) 
ONLINE: www.enterprise-architect.net/summit 

Sign Me Up for Enterprise Architect Summit, October 12-14! 

Standard Early Bird* Super Early Bird* 

9/4 and later By 9/3 By 8/13 

□ $1,050 Q$950 Q$850 



* You'll receive our discounts if you act now. To save $200 off the standard 
conference rate, register by September 3, 2003. To save $300, register by 
August 13, 2003. Your registration must be postmarked and paid in full by 
these deadlines. 

Attendee Details 

Please fill out completely and print or type information as you wish it to 
appear on your badge. Photocopy this form for additional registrations. 

Name 

Title 

Company 

Address 

City Slate Zip 

Country 

Telephone 

Fax 

E-mail 

Please call the Conference Registrar directly with any special needs. 

Payment Options 

Spaces cannot be confirmed until payment is received in the form of 
check, credit card or money order. Invoices are available for a $25 
processing fee. 

Total amount: 



Check Enclosed (Make checks payable to Fawcette Technical Publica- 
tions, Inc.) 

Charge my □ VISA □ MasterCard □ American Express 

Card no. Exc 

Name on card 

Signature 

Attention Alumni 

Have you been to a previous FTP conference? If yes, you can save an 
additional $50 off you're your registration fees when you sign up by 
September 3, 2003. Call us at 800-848-5523 (or 650-833-7100) for 
more information. 

Cancellation Policy 

You may transfer your conference registration to another person within 
your organization at any time. If you must cancel, notify the conference 
registrar in writing by September 3, 2003 to receive a refund, less a 
$150 cancellation fee. Cancellations made after September 3, as well 
as "no-shows" are liable for the full registration fee. 

In the event that Enterprise Architect Summit is cancelled by FTR 
registration fees only will be refunded. Cancellations of travel and hotel 
reservations are the responsibility of the attendee. 



Additional Information 

Please tell us more about yourself and your company. The more we 
know, the better we can further tailor your experience in Palm Desert to 
meet your unique needs. This section of the form is optional. 

1. What best defines your job title/function 

□ Technical Professional 

□ Chief/Enterprise/Strategic Architect 

□ Network Architect 

□ Other Architect 

2. What is the primary business of your organization? 

□ Communications/Publishing 

□ Construction/Architect/Engineer 

□ Consulting (computer-related) 

□ Consulting (non-computer-related) 

□ Education 

□ Financial/Accounting/Banking 

□ Government/Military 

□ Healthcare/Pharmaceutical 

□ Independent Software Vendor (ISV) 

□ Insurance/Real Estate/Legal 

□ Manufacturing/processing 

□ Telecom (Cable, Internet, etc.) 

□ Transportation 

□ Travel/Recreation/entertainment 

□ Utilities (gas, water, electric) 

□ VAR/Systems Integrator 

□ Wholesale/distribution 

□ Other (please specify) 

3. How many employees work in your entire company? (All locations) 

□ Over 50,000 □ 1,000 - 4,999 

□ 20,000 - 49,999 □ 100 - 999 

□ 10,000 -19,999 □ Under 100 

□ 5,000 - 9,999 

4. Which of the technologies below are you involved with: in terms of 
purchase, evaluation, recommendation, or support? Check all that apply 

Infrastructure Software 

□ Application Servers 

□ Wireless Technology/Services 

□ Databases (DBMS) 

□ Directory Services 

□ Storage or SAN Management 

□ Disaster Recovery 

□ Call Center Management 

□ E-business 

□ Security Software 

□ Operating Systems 

□ Network or Systems Management Software 

□ Web Server Software 

□ Monitoring Tools 

□ Web services 
Infrastructure Hardware 

□ Servers 

□ Workstations 

□ Laptops 

□ Wireless Devices 
Platforms 

□ Microsoft's .NET 

□ J2EE 

□ Unix 

□ Linux 

5. In your enterprise, do you have decision-making authority for 
technology? 

□ Yes □ No 

5b. If yes, to # 5, does your authority extend 

□ Enterprise-wide □ Department or workgroup level 

6. What percentage of your time do you spend architecting/designing 
solutions and infrastructure for your Enterprise? 

□ Over 90% □ 10% to 29% 

□ 60% to 89% □ Less than 10% 

□ 30% to 59% □ No percentage of my time 



Editors Note: Please send product information to NewProd- 
ucts Editor, do Visual Studio Magazine, 913 Emerson Street, 
Palo Alto, CA 94301; fax 650-853-0230; e-mail vsmedit® 
fawcette.com. 



Largo SQL Tools 

Largo SQL Tools is a suite of tools built on .NET technology. It 
features dependency management for those who make a lot of 
changes to a database schema. It helps you accurately deter- 
mine both parent and child dependencies in your database 
before making changes. You can also generate a list of 
unreferenced objects, such as stored procedures, tables, de- 
faults, and views, and choose whether you want to drop each 
object. Largo SQL Tools also lets you search your database 
schema in one of three ways; create data insert scripts; view 
data in a table, view, or a user-entered SQL statement, and edit 
that data if it comes from a single table; generate T-SQL code 
that will create a stored procedure that inserts or updates data 
into a specific table; and print table schemas. $69.95. 
Largo SQL Tools 
Web: www.largosqltools.com 

ORM.NET 

ORM.NET, an object relational mapping tool, autogenerates an 
ADO.NET data layer object model based on your SQL database 
schema. The generated runtime component exposes all tables 
as classes, and all columns as properties. You can use the built- 
in DataManager object to retrieve data from multiple tables 
without using stored procedures or embedded SQL code. You 
can save data updates, inserts, and deletes to the database 
with one call. $495. 
Olero Software 
Phone: 303-385-4908 
Web: www.olero.com 



Updates 



Eiffel ENViSioN! 1.1 

Eiffel ENViSioN! helps you create scalable applications and 
reusable components, and it'sfully compatible and integrated 
with the Visual Studio .NET development environment. Ver- 
sion 1,1 adds an incremental compiler for better compilation 
speed (you compile only the portions of your system that have 
changed since the last compile). Itfeatures class and feature 
browsing, autodocumentation, XML support, several code 
libraries, and EiffelBuild, Eiffel's multiplatform GUI builder. A 
free edition of the product is available at www.eiffel.com/ 
downloads/. Contact for pricing. 
Eiffel Software 



Web: www.eiffel.com 

NetAdvantage 2003 Volume 2 

NetAdvantage 2003 Volume 2features the Presentation Layer 
Framework, which lets you deliverthe look andfeel of Microsoft 
Office 2003 and Windows XP. New components include Win- 
dows Forms .NET Tab and Tab strip, Windows Forms .NET 
ExplorerBar, and ASP.NET Web Forms Listbar/ExplorerBar. 
You can design applications for all Microsoft development 
environments, including COM, Windows Forms components 
for.NET, and Web Forms components forASP.NET. The prod- 
uct comprises 85 components, including grids, scheduling, 
charting, toolbars, tabs, explorer bars, menus, listbars, trees, 
a dock manager, Ul, and more. $495; $695 with subscription; 
$995 Enterprise Edition. 



5 800-231-8588 
Web: www.infragistics.com 

RoboHelp X4 

RoboHelp X4 features FlashHelp, a new Flash-based help for- 
mat that lets you enhance your help systems with customized 
Macromedia Flash animation and sound. FlashHelp ensures 
consistent appearance and navigation for all end users, re- 
gardless of platform or browser. Additionally, the features 
introduced in RoboHelp X3's HTML authoring environment are 
now available in RoboHelp X4's Microsoft Word authoring 



environment. These features include conditional text, reengi- 
neered printed documentation output, the ability to output all 
popular help formats from a single source, and glossary sup- 
port. RoboHelp X4 includes the ability to merge help systems on 
any desktop or server, and it expands support for Adobe Frame- 
Maker. Contact vendor for pricing. 
eHelp 

Pbone: 800-358-9370; 858-847-7900 
Web: www.ehelp.com 

VMware Workstation 4 

VMware Workstation 4 includes a number of newfeatures: the 
ability to take a point-in-time snapshot of the running virtual 



machine state, save it, and revert back to it to ease testing and 
debugging; full support for both user- and kernel-level 
debuggers; the ability to share files between guest and host 
VMs by using a shared folder, or drag and drop file icons 
between virtual machines; tabbing between VMs; and im- 
proved sound and video. Version 4 alsofeatures a new Linux Ul 
that's been refreshed and updated, as well as broad device 
support. $299 (electronic); $329 (packaged). 
VMware 

Phone: 877-486-9273; 650-475-5000 
Web: www.vmware.com 
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North Wind Products 



CategoryName ProductName 
E Category : Beverages 
□ Category : C< 

Condiments Aniseed Syrup 

Condiments Chef Anton's Cajun Seasoning 



QuantrtyPerUnit 



12 • S50 ml bottles 
46 - 6 oz jars 



On Order ReorderLevel Discontin, 



$10.00 _ 
$22.00 



H Uisconon... ^ 



24 - 250 ml bottles 
12 - 8 oi jars 
20 - 2 kg bags 
32 - 8 oz bottles 
24 - 8 oz jars 
12 - 12 oz jars 
12 boxes 

24 - 500 ml bottles 
15 - 625 g jars 



Condiments Genen Shouyu 

Condiments Grandma's Soysenberry Spread 

Condiments Gula Malacca 

Condiments Louisiana Fiery Hot Pepper Sauce 

Condiments Louisiana Hot Spiced Okra 

Condiments Northwoods Cranberry Sauce 

Condiments Original Frankfurter grune SoBe 

Condiments Sirop d'erable 

Condiments Vegie-spread 
Units on order: Aniseed Syrup, Louisiana Hot Spiced Okra 
Category : Confections 

Confections Chocolade 

Confections Gumbar Gummibarchen 

Confections Maxilaku 

Confections NuNuCa NuB-Nougat-Creme 

Confections Pavlova 

Confections Schoggi Schokolade 

Confections Scottish Langbreads 




10 pkgs. 

100 • 250 g bags 
24 - 50 g pkgs. 
20 - 450 g glasses 
32 - SOO g boxes 
100 - 100 g pieces 
10 boxes x 8 pieces 



$15.50 

$25.00 

$19.45 

$21.05 

$17.00 _ 

$40.00 

$13.00 

$28.50 

$43.90 



$12.75 
$31.23 
$20.00 
$14.00 
$17.45 
$43.90 
$12,50 _ 
*ri nn 



□ 
□ 
□ 
□ 
□ 

n 



Sweet and savory sauces, relishes, spreads, and seasonings 



Chef Anton's Gumbo Mix 
36 boxes 
$21.35 



ADO, DAO Data Binding 

Unbound mode: Event driven or using interfaces 

Variety of cell edits types: single and multi-line edit box, action button, 
check box and combo box 

Supports Alpha blending and gradient fills 

Implements a stage driven, custom draw mode you can intercept and 
replace one or more stages in control's paint cycle 

Data highlighting using styles 

Odd-Even rows highlighting 

Preview panel allows you to show contents of one column inside the 
preview pane 

Single or multiple column sorting 

Outlook style grouping and Group Calculations: Users can select one or 
more columns and group rows based on values in selected columns 

Frozen Rows and Columns 

Supports Print and Print Preview using Data Dynamics' Active Reports 
Viewer Control (included) 

Natively supports export to Excel worksheets. Excel not required. 
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Fax 899-2943 
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PropertyGrid Control 



Build Flexible Uls 
With 




The PropertyGrid control makes rapid user interface 
development safe and flexible. 




□ VB.NET 

ffiTC# 

□ SQL Server 2000 

□ ASP.NET 

□ XML 

□ VB6 

Sf Other: 

Reflection 



by Jonny Anderson 

An effective interface should be robust and intuitive. Writing custom 
Uls from scratch can be time-consuming or even time- wasting if the 
UI is an intermediary version or only for testing purposes (see the sidebar, 
"Explore Your UI Options") . You need a shortcut that allows you to create 
robust, intuitive, and reusable Uls quickly and with little effort. 



The PropertyGrid control exists to provide 
such a shortcut. If you give the PropertyGrid a 
.NET object, it provides a simple read-write 
interface to the object's property values. I'll show 
you how to take advantage of the PropertyGrid 
control. You'll start by building an instant inter- 
face; then, I'll introduce you to the classes and 
code you can use to extend the control (down- 
load full VS.NET 2003 C# and VB.NET ver- 
sions of the source code from the KSMWeb site; 
see the Go Online box for details). If you need to 



Go Online! 



Use these Locator+ codes at www.visualstudiomagazine.com to go directly 
to these related resources. 

Download 

VS0308JA Download the code for this article, which includes C# and VB.NET versions 
of a demo application that demonstrates basic use of the PropertyGrid control and 
implementation of custom property editors to generate a rich UI for a custom-built 
document object model. 

Discuss 

VS0308JA_D Discuss this article in the .NET Framework/IDE forum. 
Read More 

VS0308JA_T Read this article online. It includes Listing 4. 

VS0206QA_T Q&A, "Develop Rich-UI Apps," by Karl E. Peterson and Juval Lowy 

VS0112BB_T Black Belt, "Create Customizable Uls With ATL," by Mark Schmidt 



ai 



VS0302DT_T Desktop Developer, "Develop Composite Controls," by Douglas Gennetten 
and Jonathan Lurie 



convert the files to VS.NET 2002, you can use 
the VSConvert utility (see Additional Resources) . 
You'll end up with a flexible and extendable read- 
write interface that can interact with almost any 
type of data. 

Start by building a test Employee class you'll 
hook up to a PropertyGrid to create an instant 
interface: 

public class Employeel 
private string _Name; 
private DateTime _D0B; 
public Empl oyee( stri ng name, 
string birthday)! 
_Name=name ; 

J0B=Da teTi me. Parse (bi rthday ) ; 

public string Name! 
getlreturn _Name: I 
setl_Name=value; 1 

1 

public DateTime D0B1 
get! return _D0B: 1 
set{_D0B=value; ) 



This first version of the Employee class defines 
two properties. The Name property is a string, 
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Explore Your Ul Options 



This article shows you how to take advantage of and extend 
VS. NET's built-in PropertyGrid control. The ability to build powerful 
U I enhancements, like the one described in this article, has always 
been one of the great strengths of Visual Studio. You can extend the 
VS. NET environment in many different and powerful directions, but 
you don't have to build everything from scratch. For instance, time 
might be an issue, or you might not want to implement a particular 
feature yourself. There is a plethora of tools out there that do much 
of the grunt work for you, especially in the area of building Uls. 



This short list details some of the major offerings from compo- 
nent vendors in the area of grid controls, one of the most popular 
areas for Ul enhancement and refinement. This list provides infor- 
mation on pricing, as well as the company's Web site where you 
can get more information. The decision to build vs. buy is one that 
needs to be made on a case-by-case basis, and the ultimate 
decision depends on a lot of factors. You will give yourself the most 
flexibility if you take your build-vs.-buy decisions into account during 
the planning and design stages of a given project. — Eds. 



Grid Components — Web Forms 




ASPxGrid Suite 
DbNetGrid 

Spread for Web Forms 

UitraWebGrid 

WebGridforASP.NET 



Developer Express 
DbNetLink 

FarPoint Technologies 

Infragistics 

ComponentOne 



49.99 
$599 
$599 
$395 
$399.95 



www.devexpress.com 
www.dbnetlink.co.uk 
www.fpoint.com 
www.infragistics.com 
www.componentone.com 



Grid Components — Win Forms 



i site 



Essential Grid 
FlexGridfor.NET 
GridEX Control for .NET 
True DBGridfor.NET 
UltraWinGrid 
XceedGridfor.NET 
XtraGrid Suite 



Syncfusion 
ComponentOne 
Janus Systems 
ComponentOne 
Infragistics 
Xceed Software 
Developer Express 



$395 
$399.95 

Contact for pricing 

$399.95 

$395 

$399.95 

$299.99 



www.syncfusion.com 

www.componentone.com 

www.janusys.com 

www.componentone.com 

www.infragistics.com 

www.xceedsoft.com 

www.devexpress.com 



and the DOB (date of birth) property is a DateTime. You initialize 
both these property variables in the constructor. 

You need a WinForms form that contains a PropertyGrid in 
order to display these properties. The PropertyGrid control isn't 
part of the VS.NET default toolbox, so right-click on the toolbox 
and select Add/Remove Items. Select the .NET Framework Com- 
ponents tab, scroll down until you find the PropertyGrid entry, and 
click on its checkbox. You can add a PropertyGrid control to your 
test form now. 

You want the PropertyGrid to provide a read-write interface to 
an instance of the Employee class. You must set the Property- 
Grid.SelectedObject property to an Employee object in order ro do 
this. The sample code comes with a test form called FormMain, 
which comprises a TreeView and a PropertyGrid. Assuming you 
used the FormMain constructor to create a single instance of the 
Employee, you could set the PropertyGrid.SelectedObject property 
to this Employee object, and the PropertyGrid would provide a 
read-write interface instantly (see Figure 1): 

employee _Emp=new Employee t 

"Jonny Anderson", "16/02/68"): 
public FormMainOI 

Initial! zeComponent( ) ; 



Properties .Sel ectedObject=_Emp ; 



This interface is more powerful rhan it looks. The Name property 
is a simple string and works as expected. However, if you select the 



Employee Properties 



ED- Employees 
Employee 
[;•■■ Employee 
Employee 
}■■■ Employee 
■■■Employee 



' is! ■■'■■■' ■ 1 


|B Misc 


Name 


Jonny Anderson 


■ DOB 


■ 1602/1968 J| 






DOB 





Figure 1 Create an Instant Interface. The PropertyGrid control cre- 
ates an instant read-write interface to any .NET object automatically. 
The DOB property displays a dropdown button when selected. 
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O Compiled Page Execution ASP.NET pages are compiled once and cached in memory instead of being interpreted each time 
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PropertyGrid Control 



DOB property, you're rewarded with a neat little date-picker 
dropdown (see Figure 2). The date-picker helps the user select valid 
dates. It also handles input validation, because the PropertyGrid 
knows the type of the property it's displaying and consequently the 
type to expect from the user, and it validates accordingly. 

Now, give the Employee class some interesting properties (see 
Listing 1). The code in Listing 1 adds two new properties. The 
first — Position — is of type EmployeePosition, a custom enum you 
define at the head of the Employee class. The second — Color- 
Scheme — is of type System. Drawing.Color (see Figure 3 for the 
resulting PropertyGrid interface). 

Mark Up Properties With Attributes 

Listing 1 shows the words Description and Category in square 
brackets above each property. These bracketed words are called 
attributes. Attributes provide the PropertyGrid with additional 
information and help it create an intuitive interface. You mark up 



Employee Properties 



H Employees 
Employee 
Employee 
Employee 
Employee 
Employee 



□ Misc 



Name Jonny Anderson 


IIMSM | 1602/1968 




□ 


February 1968 


D 


Mon Tue Wed Thu Fri Sat 


Sun 


29 


30 31 1 2 3 


4 


5 


6 7 8 9 10 


11 


12 


13 14 15 <£* 17 


18 


19 


20 21 22 23 24 


25 


26 


27 28 29 1 2 




4 


5 6 7 8 9 


10 


ClD Today: 11/02/2003 





Figure 2 Get a Free Date-Picker. Selecting the DOB property causes 
a dropdown button to appear. Clicking on the button invokes a neat 
date-picker control. The date-picker is initialized with the current DOB 
and updates the property value when the user is finished. 



j Employee Properties 



B Employees 
Employee 
Employee 
Employee 
Employee 
Employee 




Color Scheme 



Jonny Anderson 
16/02/1968 
!□ 192, 192, 255 j 



ColorS cheme 

The color scheme this employee has 
selected for their office. 



Figure 3 Attributes Show the Way. The [Description] and [Category] 
attributes increase usability by adding help text and property group- 
ing. You can also see the new Position and ColorScheme properties. 



both the Position and ColorScheme properties with a [Description] 
and a [Category] attribute. You use [Description] as help text that 
appears in the bottom pane of the PropertyGrid. The [Category] 
attribute groups properties visually under a single expandable 
header (see the sidebar, "Add to Metadata With Attributes"). 

Selecting the ColorScheme property reveals a color-picker 
dropdown in the same vein as the DOB property. Notice the swatch 
of color the menu displays beside the property value. The 
PropertyGrid allows you to place a small bitmap in this position for 
any property, a trick I don't cover here (see Additional Resources). 

The Position property reveals a dropdown that contains the values 
that the EmployeePosition enum defines (see Figure 4) . The Property- 
Grid detects that the Position property is an EmployeePosition enum 
and builds a dropdown automatically to deal with this constraint. The 
PropertyGrid builds a dropdown automatically for any enum. 

You've seen how the PropertyGrid can build a safe user interface 
to custom objects instantly. Now, you can start to extend the 
PropertyGrid's default behavior. The first task is to add customizable 
sorting to control the order of the properties in the PropertyGrid. 
You sort the properties by setting the PropertyGrid. ProperrySort 
property. This is fine, but you're restricted pretty much to either 
alphabetic or categorized sorts. You can't specify a custom order for 
your properties, and this lack of control becomes frustrating. You 
can fix this problem by writing a class called EmployeeSort, which 
intercedes between the Employee class and the PropertyGrid to sort 
the property names before the PropertyGrid displays them. 

This code shows a modified Employee class definition: 

[TypeConvertert 

typeof ( Empl oyeeSort))] 

C# • Upgrade Your Employee 



public class Employee! 

public enum Empl oyeePosi ti on I Di rector , 

Manager, Worker, Janitor, Coderl; 
private EmployeePosition .Position; 
private Color .ColorScheme; 

//previous properties 

[Descri pti on( "The position this employee holds 
with the company."). Categoryt "Company" )] 

public EmployeePosition Position! 
get! return _Position;l 
set l_Posi ti on-=val ue; ) 



[Descriptiont "The color scheme this employee 

has selected for their office."). 

Category ( "Personal " ) ] 
public Color ColorScheme! 

getlreturn _Col orScheme : I 

set (_Col orScheme=val ue; I 

) 



Listing 1 The Employee class provides test properties for the 
PropertyGrid. You mark up the properties with attributes that provide 
the PropertyGrid with additional information. The PropertyGrid cre- 
ates an interface for each property, depending on its type. The Color- 
Scheme property results in a color picker dialog, and the Employee- 
Position enum results in a dropdown containing the enum values. 
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100% C# Reporting Engine and a Fully Integrated Designer 

Integrated Toolbars 



Toolbox Integration Label, 
Textbox, Checkbox, 
Picture, Line, Shape, jT. 
Rich Textbox, 
Subreport, Page Break, 
Barcode, Ole Object 
and Custom Controls 



Easy to use, banded, fully ' 
integrated report designer. 
Report Header and Footer, 
Page Header and Footer, 
Groups, Keep together 
control 

Online help and detailed 
instructions 





Built in report wizard 
and converters. 



Complete Code Integration. Use 
VS.NET editor to write code 
behind your reports in C# or 
VB.NET. Unlimited Flexibility. 



Easy to use Report Wizard helps 
you get started creating simple 
reports then customize them using 
the integrated designer. 



Microsoft® Access Report 
Conversion wizard helps you con- 
vert existing Access reports to 
ActiveReports for .NET. 



ASP.NET Server Control helps 
you set up ActiveReports web 
client viewer options (HTML, 
ActiveX, .NET and PDF viewers). 
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Got data? Show it! 
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Explorer 
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Integration 



WinForms Viewer 
Control. Split views, 
multi-page view, text 
search, table of contents, 
customizable toolbar. 

Export to Adobe® PDF, 
Microsoft Excel, Rich Text, 
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Images. 



Royalty Free End User 
Report Designer. Share 
the power and flexibility of 
ActiveReports designer with 
your end users. 



View your reports on the 
internet with the HTML 
viewer control, ActiveX 
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Reader. 
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PropertyGrid Control ) 



public class Employee 
( 

// Employee code 



Note the new [TypeConverter] attribute. This attribute takes a 
System.Type object as a parameter. You can use any class type here, 
but it must derive ultimately from a System.ComponentModel.- 
TypeConverter class. The .NET Framework provides a range of 
useful TypeConverters you can pass to the PropertyGrid by using 
the [TypeConverter] attribute. These classes act as a bridge between 
your class and the PropertyGrid. One of these extended classes is 
called System. ComponentModel.ExpandableObjectConverter. The 
EmployeeSort class derives from ExpandableObjectConverter and 
provides the information required to sort the Employee class 
properties. 

The EmployeeSort class is quite simple: 

internal class 

Empl oyeeSort:BaseSorter 



Employee Properties 



S Employees 
Employee 

; Employee 
| Employee 
i~ Employee 
L - Employee 



B Company 



Position 



Coder 



□ 



Name 
DOB 

ColorScheme 



Director 
Manager 
Worker 
Janitor 




Position 

The position this employee holds with 
the company. 



Figure 4 Enums Result in Dynamic Dropdowns. The Position 
dropdown gives the user a safe selection of values to choose from. 
This property is a custom enum you define in the Employee class. 
The PropertyGrid reacts by displaying a dropdown containing the 
enum's elements. 

Add to Metadata With Attributes 



Every class comes with additional information — called metadata — 
already built in. It describes every type and interface member 
defined and referenced in a module or assembly. You can add to 
the metadata associated with your code by marking it up with 
attributes. When your code executes, its metadata loads into 
memory. Consumers of your class can then discover information 
about its members, inheritance, and so on, as well as any custom 
metadata you might have added by using attributes. The at- 
tributes the .NET Framework supplies cover most eventualities, 
but you can write your own attributes if necessary. .NET quel ies 
the metadata at run time through Reflection services in the 
System. Reflection namespace. 



public Empl oyeeSortt ) 
I 

SortOrder = new stringf] I "Name" , 
"Position". "Rate". "DOB" . 
"ColorScheme". "Comments"!; 

1 



The EmployeeSort class derives from the BaseSorter base class, 
which derives from the ExpandableObjectConverter. The Employee- 
Sort constructor defines a string array containing the names of the 
properties in the order you want them to appear. 

The BaseSorter class does the real work of sorting the properties 
(see Listing 2). The class is abstract to indicate that you intend it to 
be only a base class for other classes. You can see in Listing 2 that 
BaseSorter overrides two ExpandableObjectConverter methods. 
The first method — GetPropertiesSupported — always returns true. 
The second method — GetProperties — returns a PropertyDescriptor- 
Collection object. 

Override GetProperties 

Overriding the GetProperties method gives you the opportunity to 
intercept and sorr the PropertyDescriptorCollection before passing 
it on to the PropertyGrid. You can sort the PropertyDescriptor- 
Collection by using its Sort method, which takes an array of strings 
that match the property names in the order you want. Simply 
change the order of the names in the string array to change the order 
of the properties. The EmployeeSort class in the sample code 
initializes the SortOrder string array with the names of the Em- 
ployee properties. You can sort any class properties in this way: 

C# • Put Your Properties in Order 



internal abstract class 

BaseSorter: ExpandableObjectConverter 

( 

protected stringf] SortOrder; 

public override bool 

GetPropertiesSupportedUTypeDescriptorContext 
context) 



return true; 



1 



public override PropertyDescriptorCollection 
GetPropertiest ITypeDescri ptorContext context , 
object value, Attribute!!] attributes) 



I 



PropertyDescri ptorCol 1 ecti on 

properties=TypeDescript or .GetPropertiest 
value, attributes); 

return properties . Sort (SortOrder ) ; 



Listing 2 The BaseSorter class provides a generic property-sorting 
mechanism. The sort order is determined by the SortOrderU string 
array, which contains a list of property names. The GetProperties- 
Supported method tells the PropertyGrid to call the GetProperties 
method by always returning true. The GetProperties method sorts 
the properties by calling the PropertyDescriptorCollection. Sort method 
and passing in the SortOrderU array. 
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• Create a Custom Type Converter 
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CanConvertFrom( ITypeDescri ptorContext 


using System. Gl oba 1 i zati on ; 


context. System. Type sourceType) 


using System. ComponentModel ; 






if (sourceType == typeof (stri ng ) ) 


internal class FormatCurrency : Stri ngConverter 


| 


{ 


return true; 


public override bool 


1 


CanConvertTo( ITypeDescri ptorContext 


return base.CanConvertFrom( con text. 


rnntpxt ^v^tpm Tvnp dp^t i nat i nnTvnp ) 
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sou rceTy pe J ; 
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public override object 


i f ( ! char . I s Number { source , 0) ) 


ConvertTo( ITypeDescri ptorContext context , 


{ 


Culturelnfo culture, object value, Type 


source=source. Remove (0 . 1 ) ; 


desti nati onType ) 


1 


( 
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typeof (System. String) && value is 


Number Format Info. Invariantlnfo, out 


doubl e) 


val )) 


1 

return ((double)value).ToString("C); 


( 

return val ; 


1 

return base . ConvertTo (context, culture. 


1 

1 


value, destinationType) ; 


return base. ConvertFrom(context , culture. 


1 


val ue) ; 

) 


public override bool 


1 



Listing 3 The FormatCurrency class provides a custom format for values displayed in a PropertyGrid. You use the [TypeConverter] attribute to 
apply it to individual properties. The ConvertTo function converts a double value to a currency-formatted string value. The ConvertFrom 
function converts a currency-formatted string to a double. You use both CanConvertTo and CanConvertFrom to determine if a given conver- 
sion is safe to perform. 



Derive a new class from BaseSorter and initialize the SortOrder 
array with the target class's property names, and don't forget to mark 
up your target class with a [TypeConverter] attribute. 

Now you'll build another custom TypeConverter called 
FormatCurrency (see Listing 3). This class converts a double value 
to a currency-formatted string and back (see Figure 5). You must 
upgrade the Employee class again to show the FormatCurrency class 
in action. This time, add a new property called Rate to hold the 
hourly amount paid to each employee: 

private double _Rate; 
//Employee class code 
[DescriptionCThe hourly rate paid 

by the company."), Categoryt "Company" )] 
[TypeConverter( 

typeof(FormatCurrency) )] 
public double Ratel 
getl return _Rate; I 
set l_Rate=va 1 ue ; ) 
I 

The preceding code marks up the Rate property with a [Type- 



Converter] attribute again. The [TypeConverter] here applies the 
FormatCurrency class to the Rate property. 

Like EmployeeSort, FormatCurrency derives ultimately from a 
.NET TypeConverter and works by overriding certain selected base 
methods. You can see in Listing 3 that the overridden methods come 
in pairs. The PropertyGrid ensures it only calls supported actions by 
asking the FormatCurrency class which actions it supports. 

The CanConvertTo method supplies an argument called 
destinationType, and the CanConvertFrom method supplies a simi- 
lar argument called sourceType. The sample code uses these values to 
determine whether the proposed conversion is safe in both directions. 

The ConvertTo method does the job of converting a double value 
to a currency-formatted string; it uses the double.ToString method to 
achieve this. The ConvertFrom method goes the other way, taking a 
currency-formatted string and convening it to a double. The Char.- 
IsNumber method detects any leading currency symbol and uses the 
string.Remove method to remove it. Then, the double.TryParse 
method converts the numeric string to a double. TryParse returns false 
if it happens to fail, and the resulting double is zero. You can trap this 
behavior and provide a suitable message if you like. 

You've seen how to use the [TypeConverter] attribute at both 
the class level (EmployeeSort) and the property level (Format- 
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PropertyGrid Control 



Currency) to provide the PropertyGrid with custom TypeConverter 
derived classes. Attributes and TypeConverters allow you to cus- 
tomize the control's default behavior by controlling and modifying 
values as they pass to and from the grid. This is a powerful tool, but 
sometimes it isn't enough. The PropertyGrid is still restricted by the 
physical limitations of its cellular interface, and certain property 
types demand a more interactive user experience. You've seen that 
the PropertyGrid interprets the DOB and ColorScheme properties 
and supplies an appropriate mini-interface automatically. Fortu- 
nately, you can also instruct the PropertyGrid to use a mini- 
interface of your own. 

Build a Mini-Interface 

The Employee class needs another upgrade. This time you add a 
new property called Comments. It's a simple string property that 
holds whatever alphanumeric comments the user likes. Note the 
new [Editor] attribute in this property: 

private string Comments; 

//Employee class code 

[Description! "Any comments regarding 

this employee."), Category (" Personal ") ] 
[Editor(typeof( 

LongStringEditor) .typeof ( 

UITypeEditor))] 
public string Comments! 

getfreturn _Comments;l 

set l_Comments=val lie; I 

} 

The PropertyGrid runs into trouble if the user tries to provide a 
lengthy comment. The cell the PropertyGrid provides for comment 
text has room for only a few words. The tool tip the PropertyGrid 
provides helps a little, but the interface is far from ideal. You can fix 
this by providing a mini-interface of your own that allows the user 
to edit longer strings. 



[Employee Properties 
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Figure 5 Format Individual Properties. You can see that a currency 
format has boon applied to the Rate property. This property is a double, 
but it appears to users in their local currency. You achieve this by 
marking up the Rate property with a [TypeConverter] attribute and 
specifying the FormatCurrency class. 



The preceding code marks up the Comments property with a 
new attribute called [Editor]. This attribute takes two arguments; 
one provides the custom editor class's type, and the other provides 
the base type of that custom editor class. The second argument is 
always UITypeEditor, because a custom editor class must always 
derive from the base System. Drawing. Design. UITypeEditor type. 
The custom editor class in the example is called LongStringEditor 
(download Listing 4). 

The [Editor] attribute tells the PropertyGrid to use the 
LongStringEditor class to provide a custom interface. The presence 
of this attribute over a property forces the PropertyGrid to show an 
ellipsis (...) button when selected. If the user clicks on the ellipsis 
button, the PropertyGrid hands over control to the LongStringEditor 
class, which then provides an appropriate UI. 

Listing 4 shows that the LongStringEditor class overrides two 
methods of the base UITypeEditor class. The GetEditStyle method 
returns a UITypeEditorEditStyle, which tells the PropertyGrid to 
expect either a dropdown (like the date-picker and color-picker) or 
a modal form. You provide a form, so the return here is UIType- 
EditorEditStyle.Modal. The simple form comprises a multiline 
textbox and standard OK and Cancel buttons. It has one custom 
property called LongString that gets and sets the textbox's value. 

The LongStringEditor class also contains a method called 
EditValue. This method is responsible for displaying the UILong- 
String form. You need the current value of the Comments property 
in order to initialize the form. The ITypeDescriptorContext argu- 
ment provides this. You must cast this argument to the correct class 
type (Employee) before accessing the Comments property value 
directly. The retrieved comment text is then passed to a new instance 
of UILongString (called editor in the code) by using its LongString 
property. You show the form to the user by using the ShowDialog 
method of an IWindowsFormsEditorService instance (called _Ser- 
vice in the code). You can obtain a reference by using the 
IServiceProvider.GetService method, and the EditValue method 
kindly supplies an IServiceProvider argument for this purpose. 

The user is free to edit the comment text as he or she pleases, once 
the form is displayed (see Figure 6) . If the user then clicks on the OK 
button, the new comment text is extracted from the form's LongString 
property and returned. The PropertyGrid uses this return value to 
update the Comments property. The PropertyGrid knows which 
Employee instance to update because it interacts with whatever 
object it finds in its SelectedObject property. 

Get Real 

Now you can turn to integrating a PropertyGrid into a real 
application. The sample code contains a form (called FormMain) 
containing a TreeView control (called Tree) and a PropertyGrid 
control (called Properties). The TreeView is populated at startup 
with nodes to represent employees. You set each employee node's 
TreeNode.Tag property to the actual employee object it represents: 

empl oyees=new TreeNodet "Empl oyees" ) ; 
for(int e=0; e<5;e++){ 

node=new TreeNode( "Empl oyee" ) ; 

node.Tag=new EmployeeO; 

employees. Nodes. Add(node) ; 
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PropertyGrid Control 



The TreeView fires its AfterSelect event when the user selects an 
employee node. You can recover the Employee instance from the 
selected TreeNode.Tag property and use it to set the Property- 
Grid.SelectedObject property. The PropertyGrid updates its inter- 
face automatically to display the selected employee: 



public class Employee : IBrowsable 



//Employee Code 



publ 1c void Savet ) 



private void Tree_Af terSel ect( object 
sender, TreeVi ewEventArgs e) 

I 

Properties .Sel ectedObject= 
e. Node. Tag; 

) 

The PropertyGrid fires its PropertyValueChanged event when 
the user changes a property value. The PropertyValueChanged- 
EventArgs argument supplies both the new and the old value for 
the property, so this is a good place to put simple input validation 
if writing a TypeConverter class seems like overkill. 

You can also use this event to save any changes the user has made. 
The sample code demonstrates this by adding a Save method to the 
Employee class and calling it during the PropertyValueChanged 
event. You can use the PropertyGrid.SelectedObject property to get 
a reference to the currently selected Employee. This property's type 
is System. Object, so the reference you get doesn't give you access to 
the Employee.Save method. You could simply cast the SelectedObject 
to Employee, but this fix will fail if — as is likely — you have more 
than one type of class to display (for example, Employees and 
Customers). A good solution is to define a common interface that 
any class you plan to display in the PropertyGrid can implement. 
The sample code defines an interface called IBrowsable, and the 
Employee class implements it: 

public interface IBrowsable 
{ 

voi d Savet ) ; 
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Figure 6 Implement the Long String Editor. The editor for the Com- 
ments property requiies an extended interface to deal with long 
strings. You mark up the property with the [Editor] attribute, which 
connects it to the LongStringEditor class; this class displays the long 
string editor form. 



//save data 



You can now cast the SelectedObject property to IBrowsable 
safely during the PropertyValueChanged event and call the Save 
method to serialize any user updates. Here's the finished code for the 
PropertyValueChanged event: 

private void 

Properti es_PropertyVal ueChangedt 
object s, 

PropertyVal ueChangedEventArgs e) 

I 

IBrowsable browsable = 
( I Browsable) Properti es. 
Sel ectedObject ; 

browsabl e . Savet ) : 



You've learned how to extend the PropertyGrid's default behav- 
ior with property sorting, value formatting, and a nifty custom UI 
for editing long strings. Each extension involves deriving your own 
custom classes from various .NET Framework classes and overrid- 
ing selected methods. You use attributes to mark up a class and 
thereby provide the PropertyGrid with its enhanced capabilities. 
Finally, you've seen how you can integrate a PropertyGrid quickly 
into any application by using only its SelectedObject property and 
a simple shared interface. I've barely scraped the topsoil, but what 
I've revealed should be enough to encourage exploration of your 
own. You might want to focus on the ExpandableObjectConverter. 
This class allows the PropertyGrid to display custom object hierar- 
chies and gives a powerful treeview effect, vsm 



Jonny Anderson is a coder who lives and works in Edinburgh, 
Scotland. He enjoys writing C# evolutionary algorithms that optimize 
complex, nonlinear models. As a consequence, he is poor as a church 
mouse and likely to remain that way. Contacthimatjonny@joyofvb.com. 



Additional Resources 



• "Getting the Most Out of the .NET Framework PropertyGrid 
Control" by Mark Rideout: http://msdn.microsoft.com/library/ 
?url=/library/en-us/dndotnet/ntml/usingpropgrid.asp 

• "Make Your Components Really RAD with Visual Studio .NET 
Property Browser" by Shawn Burke: http:// 
msdn. microsoft.com/libra ry/default.asp?url=/library/en-us/ 
dndotnet/html/vsnetpropbrow.asp 

• "A Utility to Convert VS.NET 2003 Project Files" by dacris: 
www.codeproject.com/useritems/vsconvert.asp 
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Spotlight 



In 1991, Visual Basic's introduc- 
tion had a revolutionary impact 
on software development. In ad- 
dition to drag-and-drop user in- 
terface development and a 
sophisticated runtime envi- 
ronment, Visual Basic 1 .0 in- 
cluded the first model for 
pluggable components. This 
model, the VBX interface, al- 
lowed the creation of a new 
marketplace — third-party 
component vendors. Visual 
Studio Magazine — then called 
BasicPro, later Visual Basic 
Programmer's Journal — cov- 
ered those early components 
as extensively as it does today's 
components, and helped 
bring wide awareness of components to 
Microsoft developers. 

Twelve years have brought many 
changes. The predominant model for 



pluggable components evolved from VBX 
to ActiveX, and later to the .NET Frame- 
work. But one thing hasn't changed. It's 
still a lot cheaper, faster, and more effec- 



tive to buy plug-in functionality than to 
develop it in-house — particularly for 
today's enterprise developer tasked to 
produce more with fewer resources. 



"Commercial software components of- 
fer development organizations unequalled, 
expert solutions, domain knowledge, 
technical support, and quality assurance," 
explains David Quigley, execu- 
tive director of the Component 
Vendor Consortium (www. 
components.org). "In-house al- 
ternatives require resources dedi- 
cated to developing domain ex- 
pertise, architecting the solu- 
tion, coding, documenting, test- 
ing, and fixing the inherent bugs 
that come with every piece of 
new code. When you add to this 
the fact that most third-party 
commercial software compo- 
nents carry a price tag equiva- 
lent to only a few hours of work, 
it should make incorporating reusable com- 
mercial software components standard 
protocol for every new software develop- 
ment project." 
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Since, as Quigley explains, most 
third-party components cost about the 
same as a few hours of work, expert 
enterprise developers consider third- 
party components first. Not only do 
they offer more functionality and sta- 
bility than in-house alternatives, but 
they sometimes offer capabilities im- 
possible to build independently given a 
project's many resource restrictions. In 
some cases, a development effort would 
not even be practical without plug-in 
components to help accomplish some of 
the heavy lifting. 

Plug-in components for functions 
such as graphics, charting, imaging, and 
fancy user interfaces are great examples. 
This kind of functionality can be used 
in a broad range of applications, but it 
is complex and difficult to develop. 
Purchasing such functionality is far 
more economical and practical than 
developing it. 



Understanding Graphics 
and Imaging Components 

As technology evolves, even the sawiest 
developers find it difficult to keep 
abreast of the latest developments. The 
general category of graphics tools is an 
excellent example. A decade ago, 
"graphics" could have referred to basic 
user interface components, charts, or 
perhaps image storage and manipula- 
tion, to name a few. 

Today, graphics tools encompass a 
wide variety of capabilities, from the ex- 
tensive suite of image-manipulation ca- 
pabilities in products such as LEAD- 
TOOLS to barcode manipulation. The 
decade-old basic charting components 
have been superceded by a new genera- 
tion of advanced charting tools, such as 
those from Software FX, Janus Systems, 
and more. Graphics components have 
embraced digital document creation with 
PDF generating tools. 



And the graphics component category 
— broad as it is — shows continuing 
innovation, as these new categories con- 
tinue to expand and mature. New prod- 
ucts — like Data Dynamics' latest, #Grid 
— continue to expand the category. 

In this brief introduction, you'll learn 
a little about some of these key catego- 
ries and be introduced to some of the 
industry-leading technologies that show- 
case the best of what components and 
tools have to offer. 



Imaging Components 



Dozens of formats, complex algorithms, 
low-level bit manipulation — how many 
of us have both the time and the talent to 
do that kind of development? Fortu- 
nately, we don't have to. Several vendors 
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offer comprehensive tools for imaging 
programs. For applications from health- 
care to security to research science, 
image manipulation can prove that "a 
picture is worth a thousand words." 

Common capabilities for imaging com- 
ponents include loading, displaying, and 
manipulating bitmapped and vector- 
based images in a wide variety of formats. 
Performance is an important consider- 
ation for imaging software, because it is 
common for an image to involve large 
amounts of data, and for image manipu- 
lation to require intense processing. 

LEADTOOLS 

from LEAD Technologies 

For the widest variety of formats and the 
most comprehensive set of manipulation 
options, it's hard to beat LEADTOOLS. 
Start with more than 120 formats for bit- 
mapped (raster) images, including some 
highly specialized ones, such as DICOM 
for medical imaging, which is part of the 
Medical Imaging toolkit. Then add in 
various options for compression, more 
than 2,000 paint effects, color conver- 
sion, and more. LEADTOOLS also fea- 
tures the ability to manipulate common 
vector image formats. It's not easy to find 
an imaging function that's not included 
in LEADTOOLS. 

LEADTOOLS represents an all-em- 
bracing approach to imaging technolo- 
gies. Its SDKs include capabilities for 
manipulating vector images, multime- 
dia images, raster images, document im- 
ages, and more. And "manipulating" 
includes everything from creating, edit- 
ing, and storing to compressing and 
converting. In fact, LEADTOOLS is 
available as an imaging library on more 
than just Windows platforms — LEAD 
Technologies recently announced a 
Pocket PC imaging library as well as 
upgrades to its LEADTOOLS Image 
Server, an ISAPI extension for Microsoft 
IIS 4 and higher. 

For more information about the 
award-winning LEADTOOLS family, 
visit LEAD Technologies on the Web at 
www.leadtools.com. 

dotlmage from Atalasoft 

For those who would like a solution that 
is totally within the .NET Framework, a 
new entry from Atalasoft is available. It's 



called dotlmage, and it's built from the 
ground up in C#, part of Microsoft 
Visual Studio .NET. dotlmage supports 
raster, document, and ASP.NET Web 
imaging, and its rich, easy-to-use object 
model is targeted at mainstream imag- 
ing applications. Visit Atalasoft on the 
Web atwww.atalasoft.com to learn more. 

ImageLib Corporate 
Suite from SkyLine Tools 
Imaging 

For those seeking in-depth imaging capa- 
bilities with royalty-free licensing, check 
out ImageLib Corporate Suite. Available 
for a variety of environments, such as VB, 
C++, and Delphi, ImageLib has advanced 
capabilities for scanning and image cor- 
rection. Visit SkyLine Tools Imaging on 
the Web at www.imagelib.com. 
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Charting 



Today's business world generates more 
data than anyone can get a handle on. 
Many applications are tasked with just 
that — turning data into information. 
There's no better way to do that than to 
create an easy-to-understand chart. From 
pie charts to scatter graphs, charting can 
make information accessible for under- 
standing and decision making. Charting 
components — like those from Software 
FX, Graphics Server, Steema Software, 
and GigaSoft — provide tools needed for 
this job. 

Charting tools differ from other graph- 
ics tools in that they focus specifically on 
taking data and turning it into usable 
visual forms. They typically offer a broad 
range of charting options and ways to 
easily tie the data into the chart. The 
output of a chart might need to be in 
various formats, and charts often need to 
be printed as well as viewed. Charting 
packages vary in the formats and options 
they support, and whether they are tar- 
geted for desktop or Web applications 
(or both). 

Chart FX 

from Software FX 

Offering a wide range of charting prod- 
ucts, Software FX aims to meet a variety 
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of charting needs for mainstream appli- 
cations. Chart FX is available for .NET, 
for COM, and even for the Pocket PC. 
It's available in a full-featured version, 
and as Chart FX Lite for those with 
simpler demands. At the high end, a 
variety of plug-in extensions are avail- 
able for specialty areas such as OLAP 
and finance. Chart FX is suitable for 
both desktop and Web use, and allows 
data to be populated into charts from a 
nice variety of sources. For example, 
Chart FX for .NET can use data from 
ADO.NET, XML, collections, arrays, 
and text files. 

Chart FX for .NET, a Visual Studio 
Magazine 2003 Readers Choice Award 
winner, sports sophisticated UI capabili- 
ties such as transparency, gradients, back- 
ground images, and borders. But the lat- 
est edition includes more than UI en- 
hancements — it reflects a strong step for- 
ward in core capabilities as well, from 
new chart types and zoom enhancements 
to extraordinary Internet capabilities. The 
new Internet capabilities include a Web 



Forms component and high-performance 
boosters such as direct-to-browser bit- 
streaming from a server. 

Software FX recently announced 
Chart FX Extensions, which extend the 
product's capabilities to specialized ap- 
plications and more vertical industries. 
For more information about Chart FX, 
visit the company on the Web at 
www.softwarefx.com. 

ProEssentials 
from GigaSoft 

Leveraging nine years of evolution for its 
charting software, GigaSoft offers a wide 
variety of options and outputs in Pro- 
Essentials. Tried-and-true code with in- 
depth functionality is the core of the 
package, in a set of DLLs that offer a great 
combination of features and stability. 
However, deployment is not compro- 
mised, as these proven libraries can be 
included in a .NET project by just copy- 
ing them into place. Visit GigaSoft on 
the Web at www.gigasoft.com to learn 
more details. 
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total output control 



DynamicPDF™ Generator.NET v1 .5 Visit our website at DynamicPDF.com 

.NET version of Generator, 7 00% managed code, many new features: Download our free version, 



HTML text formatting 

PDF encryption 

custom Page Element API 



8 image types 
bookmarks and outlines 
TrueType font embedding 



DynamicPDP™ Generator v2.5 

programmatically generates PDF documents straight to IIS's HTTP output stream, 
a file, or a byte array 

DynamicPDF™ ReportWriter v1 .5 

integrates with ADO allowing for quick and easy generation of PDF reports 
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Sales Manager 
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Graphics Server 
from Graphics Server 

Startingway back in DOS, Graphics Server 
has evolved a wide range of charting func- 
tionality, winning many awards along the 
way. The latest version is totally based on 
the .NET Framework. Graphics Server 
never requires server licensing, which can 
make it a cost-effective solution for Web 
applications and commercial packages. 
Available for both COM and .NET (with 
100-percent managed code), Graphics 
Server details are available on the Web at 
www.graphicsserver.com. 

TeeChart from 
Steema Software 

With deep roots in the Delphi commu- 
nity, Steema Software has been developing 
charting applications since 1996, and re- 
cently introduced the .NET version of its 
flagship TeeChart package. TeeChart for 



.NET is written in 100-percent native C# 
code, and can be used for charting in 
Windows Forms, Web Forms, and on 
mobile devices. Visitwww.steema.com for 
more details on this breakthrough release. 



PDF Tools 

Sometimes HTML just isn't good enough 
for sophisticated content layout. The 
high-end alternative has traditionally 
been Adobe Systems' Portable Docu- 
ment Format, more commonly known 
by its acronym of PDF. While the PDF 
reader (Adobe Reader) is free, authoring 
PDF documents is not. Many applica- 
tions need a way to create documents in 
the PDF format. Luckily, exceptional 
vendors such as these offer creation of 



PDF documents using various content 
from various sources. 

activePDF Toolkit 
from activePDF 

activePDF offers a broad range of prod- 
ucts for producing PDF output. For con- 
version from sources such as Word or 
Excel, to a toolkit for from-scratch cre- 
ation of PDF content, there's an option 
available. activePDF products are all 
COM-based, but .NET wrappers are 
available for major programmable com- 
ponents to enable developers with Visual 
Studio .NET to take advantage of active- 
PDF capabilities. You'll find the easy-to- 
use .NET wrappers for all major active 
PDF products, including activePDF 
Toolkit, activePDF Server, and active- 
PDF DocConverter. Visit activePDF on 
the Web atwww.activepdf.com for more 
details. 
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Integrate sophisticated 
imaging into your .NET 
applications with dotlmage™ 

• Fast, effective, and easy to use 

• Save months of development effort 

• Interactive user controls 

• Extend or replace 6DI+ 

Atalasoft dotlmage was developed from the ground up using managed C#. 
dotlmage Is one of the first imaging components specifically designed for NET. It 
Includes all relevant features of our popular ImgX Controls ActiveX product with 
many new performance and feature enhancements, dotlmage offers developers 
fjnctionality that is fast, effective, and easy to learn. 

V Raster Imaging 
1/ Document Imaging 
J ASP.NET Web Imaging 
4 WinForm and WebForm Controls 

Evaluation of dotlmage for Microsoft®.NET today! 
http://www.dotimage.net 

ActiveX imaging components also available: 
ImgX Controls - Imaging, Printing, and Scanning for VB 
ImgXASP - ASP Web Imaging Membw of 

413-572-4443 ^Component Vendor Consortium 

i Court Street, Suite 3- Westfield, MA 01085 USA 





GigaSoft ProEssentiats 

version 5.0 




The best choice for engineering, financial, and serious business 
charting. Available in three strengths: Lite, Standard, and Pro. 
Each include 1000+ features, .NET WinForm and WebForm, 
ActiveX and DLL interfaces, royalty-free client-side use, one 
production license for your web-server. Visit www.gigasoft.com 
for more information. The demo is truly awesome, take a look! 

No hassle download: ftp://www.gigasoft.com/pe5setup.exe 
Includes an uninstaller. Download and see what you're missing. 



9igasoft.com 
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With a LEADTOOLS SDK in your hands, your clients or managers will think that you have spent years 
becoming an expert in the field of imaging. You will be able to handle any request thrown at you. 
Whether you need to take control of images in a database, compress and optimize your images for 
storage, view or add any other image manipulation tasks to your applications - you will be able to 
say "Yes, I can do that!" with a LEADTOOLS imaging toolkit. 



RASTER IMAGING 

Import and export 140+ raster file 
formats - Supports a wide range of 
compression options, bit depths (up to 32) and 
color spaces. Progressive and non-progressive 
modes, multi-page, animation and non-image 
data. 

90 + Image processing Filters - Transforms- 
resize, rotate, linear and bicubic interpolation, 
flip, invert, reverse, crop, underlay, shear and 
combine. Filters - sharpen, intensity, 
saturation, histogram, posterize, median, edge 
detection, noise and more. Spatial filters - 
gradient, laplacian, sobel, prewitt and more. 
Display - scroll, scale with interpolation, anti- 
alias, dither, contrast, with a choice of over 
2,000 special effects. 

Scanning, printing, imaging common 
dialogs, thumbnail browser, image list, 
database imaging functions, screen 
capture and much more! 



DOCUMENT IMAGING 

Powerful annotation capabilities - Enable 
the addition of 50+ objects including text, 
highlights, sticky notes, audio, and redaction 
all with user-defined security features. 
Document image processing & clean-up- 
Despeckle, deskew, inverted text, removal of 
dots, blobs, lines, borders, hole punches, 
character smooth. Region of interest, preview 
of changes and composite viewing of the 
modified regions. 

Optimized viewing of bitonal images - 

Specialized display filters including FavorBlack 
and ScaleToGray, bilinear and bicubic 
interpolation. Includes ultra-fast CCITT G-3, 
G-4 and rotation, JBIG compression and a pan- 
window. 

ScanSoft OCR - ScanSoft SDK 5.0 Pro engine, 
includes preset confidence and accuracy levels, 
artificial intelligence, and built-in and user- 
defined lexicons for limiting the type of text to 
recognize within a particular zone. 



INTERNET IMAGING 

Client server development over the 
Internet or LAN - Provides a framework for 
sending /receiving commands between 
computers. 

Control Image processing remotely - 

Allows for creation of "remote control" type 
applications where image processing can take 
place on a remote computer. 
Small COM objects and ActiveX controls - 

Internet enable LEADTOOLS Raster imaging 
functionality but greatly reduce redistribution 
requirements. 

New HTTP and FTP functionality - Provides 
programmatic control of FTP & HTTP servers. 
Upload Control - Send files to an HTTP server. 



DIGITAL PAINT 

Extensive high-level and low-level 
options available for brush, shape, region, 
fill and text. 



MEDICAL IMAGING 

DICOM 3.0 - Supports the latest specifications, 
including all standard IOD classes and modalities 
(CR, CT, MR, NM, US, RF, SC, VI 
and DICOM directory. 
DICOM communications proto 
COMPLETE support including all Service Classe 
(Verification, Storage, Query/Retrieve, Patial 
Management, etc). High-level communications 
functions to simplify the creation of DICOM 
client/server applications. 

Optimized image processing - The richest in 

the industry supporting 1, 2, 3, 4, 5, 6, 7, 8, 12, 
16, 24, 32, 48 and 64 bit images. Includes 8-16JJ 
bit grayscale display with window leveling aiM 
LUT support. 

Annotation - Includes Medical specific 
measuring and mark-up annotations like cross 
product, ruler, protractor and point. 



VECTOR IMAGING '4||fJ 

Import/export - DWG, DXF, DWF, EMF, WMF, 
CGM, DGN, DRW, HPGL/2, SVG, PICT and LEAD 

Editing - 14 different primitive object types 
(Vertex, line, rectangle, polyline, polybezier 
curve, polygon, ellipse, circle, arc, text, pie, 
chord, polydraw, and raster). Group objects into 
layers, copy or move objects between layers, lock 
individual layers. Add, edit, delete, rotate, 
translate and scale objects and layers. Convert 
points from world space to screen space and vice 
versa. Pixel accurate hittesting. 
Also includes 3-D viewing (lighting, shadow, 
camera), 3 vector engines (GDI, OpenGL and 
DirectX), convert or overlay vector drawings to 
any LEAD supported raster format. 



MULTIMEDIA IMAGING 

Play, Edit and Save - Comprehensive support of 
multimedia formats including AVI, ASF, 
WMA, MP3, WAV, MIDI, SND, AIF, AIFC, MPEG-1, 
MPEG-2 files. 

Capture - Capture multimedia data from any 
DirectShow (WDM) Windows driver. 

Video Codecs - MJPEG, MCMP and Wavelet. 

DirectShow Filters - Rotate, resize (bicubic and 
resample), brightness, contrast and more. 



LEADTOOLS toolkits ship with sample source 
code for Visual Basic, Visual C+ + , Visual C#, 
Visual Basic .NET, C/C+ + , C++ Builder, Visual 
J++, Delphi, and VB and Java script. And support 
for Visual Studio 6.0 database connectivity 
(Oracle, SQL, OLE DB, ODBC, and JET) 




leadtools.com 

Developer 1 

i 

Super-site 




sales@leadtools.com or call: 800-637-4699 

1201 Greenwood Cliff, Suite 400 Charlotte, NC 28204 

LEAD and LEADTOOLS are registered trademarks of LEAD Technologies. Inc. 
AM other product names are trademarks of " " 
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DynamicPDF 

Generator.NET from CeTe 

Specializing in the creation of PDF docu- 
ments on the fly, Dyna wzzrPDF has a full 
range of programmability options, and 
the latest version is 100-percent man- 
aged C# code. DynamicVXyY is espe- 
cially suitable for serving dynamic docu- 
ments in the PDF format on the Web, 
and it supports a wide variety of graphics 
options while maintaining high perfor- 
mance. Its object model is developer- 
extensible to provide maximum flexibil- 
ity. For more detailed information about 
DynamicVD¥ Generator.NET, visit 
www.cete.com. 
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Advanced UI Grids 



Experienced user interface programmers 
rapidly outgrow the controls built into 



GRAPHICS SERVER. 

Same Features 

Better ROI 





Graphics Server, with versions 
for COM and .NET, provides 
great features but doesn't 
charge for server licenses. 

* No hassles 

* No hidden fees 

* Free evaluation 



The 

NO SERVER 
LICENSE REQUIRED 

graphing and charting component. 



www.Braphicsserver.com 

Graphics Server Technologies, LP. 
800 231-1233 1 206 625-6900 



environments such as Visual Studio 
.NET. Often the first third-party con- 
trol they seek is a sophisticated grid. 
And why not? Appropriately used, grid 
controls can add tremendous function- 
ality to an application quickly. Most 
apps present or manipulate data — and 
most users are familiar with and expect 
the grid interface when they work with 
data. 

From displaying data in different 
formats to offering more editing op- 
tions, grids can improve the user expe- 
rience and significantly shorten devel- 
opment times. Let's look at a couple of 
these flexible, useful grids. 

#Grid from 
Data Dynamics 

Pronounced "sharp Grid," this product 
goes far beyond basic built-in grids, with 
an array of options for making data stand 
out. Text and pictures can be combined 
in a cell, for example, and cells have 
options for transparency 
and color gradients. It's 
even possible for the de- 
veloper to intercept the 
paint cycle and do cus- 
tom painting for a cell. 
Of course, there's awide 
variety of binding op- 
tions, as well as the ca- 
pability to operate un- 
bound. Advanced fea- 
tures include Outlook- 
style grouping of data, 
and hierarchical naviga- 
tion of parent-child data 
sets. 

A new version of the 
popular BeeGrid, #Grid 
adds a wealth of new 
features and enhance- 
ments to an already ex- 
ceptional component. 
Plus, it adds the know- 
how, support, and repu- 
tation of Data Dynam- 
ics. More standout fea- 
tures: a rich object 
model, XML-based lay- 
outs, and extensive con- 
version capabilities 
(CSV, XML, HTML, 
more). 



For more details about #Grid or other 
Data Dynamics components, visit www. 
datadynamics . com. 

GridEX from 
Janus Systems 

GridEX is superb at manipulating bound 
and unbound data, with capabilities for 
hierarchical navigation, display of detail 
records in a "CardView" mode, and the 
ability to do advanced graphics operations 
inside cells. GridEX also stands out for its 
usability and speed. A variety of input 
controls enhance the user's editing experi- 
ence without increasing development 
times. Also included are extensive filter- 
ing capabilities, with filters that are even 
aware of parent-child relations in the data. 
Janus GridEX is totally written in C#. 

In fact, the Janus GridEX Control for 
.NET not only includes sophisticated, 
"Outlook-like" hierarchical UI capabili- 
ties, but it also includes several standalone 
controls. These include MaskEdit, Multi- 
Column Combo, and UpDown controls. 
You'll also find sophisticated printing 
capabilities in the GridEXPrintDocument 
component, loaded with printing must- 
haves like a paginating method, page 
range printing, and more. 

For more details on Janus GridEX for 
.NET and other Janus products, visit 
www.janusys.com. 



Specialized 
Components 




Graphics comprise not only charts and 
images. Sometimes a specialized form of 
output is essential for a given applica- 
tion. General-purpose packages can 
sometimes be tweaked to produce such 
custom output, but buying a product 
dedicated to the purpose is usually bet- 
ter. These dedicated components pro- 
vide spot-on solutions for even the 
thorniest application challenges. 

Bar Code Software 
from TAL Technologies 

TAL Technologies has a family of prod- 
ucts for barcoding applications, includ- 
ing B-Coder Pro, Bar Code ActiveX, and 
Bar Code DLLs. This family allows the 
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addition of barcode functionality to Win- 
dows applications, no matter what de- 
velopment technology you use. Unlike 
other products, which create bitmaps or 
use fonts to produce a barcode symbol, 
TAL's Bar Code ActiveX produces a 
high-resolution Windows metafile, 




-basing such functionality 
ifar morejeconomical and 
Practical than developing it. 



which is completely device-independent, 
fully scalable, and prints to the highest 
resolution of any printer. For more in- 



formation, visit TAL Technologies on 
the Web at www.taltech.com. 

GoDiagram for .NET from 
Northwoods Software 

Certain kinds of graphics diagrams, such as 
flowcharts and workflow diagrams, are 
needed in a wide vari- 
ety ofapplications, but 
are hard to produce 
with conventional 
graphics components. 
Enter GoDiagram 
from Northwoods 
Software, which is 
written for this precise 
need. Diagrams can be 
produced with pro- 
grammable objects at 
the nodes, making it 
easy to produce a net- 
work of related objects, and nodes may 
actually encapsulate sub-diagrams that can 
be expanded or collapsed. A variety of 



NEED HANDS-ON TECHNICAL INFORMATION? 



FTPOnline — the new network of technical 
sites for IT and development professionals. 



www.thedotnetmag.com 
www.visualstudiomagazine.com 
www.javapro.com 
www.xml-mag.com 

• Downloadable code 

• Interviews with industry experts and visionaries 

• Overviews of the newest technologies 

• Links to other hotspots on the Web 

• FREE! Thousands of pages of archives and articles 

• Plus, FREE e-newsletters in your area of interest 



linking options are available. GoDiagram 
is suitable for use in both Windows Forms 
and Web Forms applications. Visit www. 
nwoods.com for more information. 



Conclusion 



Plug-in components are designed to make 
developers look good. Users appreciate 
the functionality and increased usability 
made possible by various components, 
and enterprise developers benefit from 
shorter development times. 

Many components offer demonstra- 
tions or trial versions, so it's easy to see 
what they can do in detail before you 
spend your money. This small invest- 
ment of time can lead to a big payback, 
so with a keen focus on return on in- 
vestment, components are key to the 
success of today's enterprise develop- 
ment professionals. 




FTPOnHne 




Go There Today: 

www.ftDonline.com 
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I^^^B Chart FX provides a quality charting solution with 10 years of 
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^^^^^^^^f^^^^^^yH ask yourself what this component will cost you. but rather what 

it's going to save you. For more information or to download a 
trial version, visit www.softworefx.com. 
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Merge XML Documents 



Take advantage of the XMLDocument object to combine data files from multiple 
sources. 
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Go Online! 



Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these related 
resources. 

Download 

VS0308GS Download the code for 
this article, which includes a simple 
WinForms interface that lets you 
extract information from Northwind, 
preprocess it with XSLT, and 
perform an intimate merge. 

Discuss 

VS0308GS_D Discuss this article in 
theVB.NET forum. 

Read More 

VS0308GS_T Read this article 
online. 

VS0305KD_T "Generate .NET Code 
With XSLT" by Kathleen Dollard 

VS0305DD_T Database Design, 
"Navigate Hierarchical Datasets," 
by Zane Thomas 

VS0302AN_TASP.NET, "Separate 
Form, Function, and Style," by Don 
Kiely 



XML is becoming an increasingly common 
data store. One of XML's advantages is 
that you can work with your data as discrete files 
that might come from different sources. You 
might also want to merge XML files to create 
reports, store the output in a database, or display 
it in a user interface. I'll show you how to do an 
intimate merge between discrete XML data files. 
I call it an intimate merge because it not only 
adds new elements, but it updates individual 
elements' attributes as well. Along the way, 
you'll get a better understanding of the role of 
XML Schema Definition (XSD) schemas, how 
to validate an XMLDocument object as you 
load it, and the role of recursion in processing 
XML data. 

You might use this merging process in the 
real world by taking data from several external 
sources, such as a database, output from an 
accounting package such as QuickBooks, and 
the results of a Web-based survey (see Figure 1). 
I'll simplify the example to use data from the 
Customers and Orders tables from the SQL 
Server sample Northwind database and merge it 
with a file that mimics the result of a Web-based 
satisfaction survey. You can extend the approach 
to whatever data you work with. 

Merging the three sample files direcdy won't 
work, because their structures are entirely differ- 
ent. The database-extracted files hold informa- 
tion as individual elements, and the survey holds 
information in attributes. You must perform two 
steps to merge them: Use Extensible Stylesheet 
Language Transformations (XSLT) to put them 
in similar formats, then perform the merge. This 
article's sample code shows how to extract data 
from the database and perform the XSLT trans- 
formation (download the sample code from the 
VSM Web site; see the Go Online box for details) . 
You can read more about XSLT in my article in 
the May 2003 issue (see the Go Online box). 



by Kathleen Dollard 

XSD schemas articulate rules for the layout of 
XML, including which elements and attributes 
are legal. However, merge processing works best 
in the real world if you validate the XML first. 
Otherwise, small errors in the document struc- 
ture can lead to bizarre output documents. I used 
a single XSD to validate all three input files. This 
is convenient, because it lets you know that all of 
your input XML files conform to a single set of 
rules. You don't need to create a schema from 
scratch; instead, you can right-click on an XML 
document to use VS.NET's "Create Schema" 
feature. VS.NET attempts to build a combined 
schema when multiple XML files in a project 
have the same namespace. However, it's not 
particularly good at this and sometimes drops 
attributes, so you might need to finish up your 
schema with a bit of cut-and-paste. 

Use a Consistent Namespace 

All three input files use the same namespace 
because they contain the same logical elements. If 
the elements in the different documents have 
different namespaces, the merge can't find the 
necessary matches, and you can't perform an 
intimate merge. The purpose of a namespace is to 
make a particular element unique. I own the 
domain http://KADGen, so I use it to ensure my 
element names don't conflict with someone else's. 
When you work with your own data, your XSLT 
preprocessing step often fixes namespaces, as you 
can see in the sample XSLT code. 

You merge two files at a time, with the second 
file merged into the first. Load each file as a 
validated XML document: 

Dim xmlBase As Xml . Xml Document = 

Tools. LoadVal idXMLt 

" . . \Customer .xml " , _ 

". .\Merge.xsd", ns) 
Dim xmlMerge As Xml . Xml Document =_ 
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Figure 1 Combine Multiple XML Files. You can combine multiple XML files from different sources by using a combination of XSLT and a 
generic merge process. The merge process incorporates namespaces and XML validation. 



Tool s . LoadVal i dXML( " . . \0rder . xml " , 
" . . \Merge . xsd" , ns ) 
Tool s. Me rgeRoott xml Base, xml Merge) 

The Tools class contains the important 
code for the merge (see Listing 1). The Load- 
ValidXML method uses an XMLTextReader 
to access data in the file. TheXMLValidating- 
Reader uses the XMLTextReader to read the 
data and validate that the structure of the data 
is consistent with the specified schema. XML 
data is validated as it's read, not when you 
simply open the XMLValidatingReader. In 
this case, it's read as the XMLDocument 
object loads. 

An XMLDocument holds your entire 
XML file in memory, lets you access any 
portion of the XML, and helps you main- 
tain context. Context is your position within 
the document. The best analogy for context 
is navigating a DOS hierarchy. At any point 
in time, there's one current directory, and 
you can position yourself either relative to 
that directory or from the root. When you 
work with XML objects, the context is the 
current object you're working with, such as 
the outParent variable. 

The MergeRoot method initiates the 
merge. It calls the recursive MergeNode 
method. Recursion is a fundamental pro- 
gramming tool in which a routine calls itself. 
Recursion is the best solution when you 
work with hierarchies of an unknown depth, 
such as XML. The first time you run across 
a recursive algorithm, it challenges you to 
adopt a new way of thinking. The important 



part of a recursive algorithm is a clear end 
point, so that the recursion doesn't continue 
forever. Supplying a clear end point is easy 
when you work with XML, because you 
progress down a tree, processing each node 
until you arrive at the leaf nodes. 

MergeNode Looks for 
Matching Elements 

MergeNode uses SelectSingleNode to look 
in the output document's current parent 
node for an element matching the current 
node in the merge document. It bases this 
match on the element name and on an ID 
attribute if one's available. The example uses 
a rule for the ID that consists of the name of 
the element followed by "ID," such as 
CustomerlD for an element named Cus- 
tomer. If MergeNode doesn't find a match- 
ing element, it adds the current node in the 
merge document as a child of the current 
output parent node. 

If MergeNode finds a matching element, 
the method checks each attribute and adds 
any attributes that don't exist. If the attribute 
exists, the attribute value in the merge docu- 
ment overwrites the one in the output docu- 
ment. This behavior means that the order of 
the merge matters, and the last document 
wins any conflicts. The method calls itself for 
each child element in the merge document, 
passing the current matching output ele- 
ment as the new parent. This process contin- 
ues down the hierarchy to any depth. Leaf 
nodes have no child elements, so the recur- 
sion has a clear end point. 



MergeNode uses an XMLNamespace- 
Manager for the SelectSingleNode method. 
The input documents define a namespace, 
so you must define it in SelectSingleNode 
and the similar SelectNodes methods. The 
XMLNamespaceManager class doesn't sup- 
port default namespaces. Default namespaces 
are namespaces that don't have a prefix, such 
as the elements in your input documents. 
The XMLNamespaceManager needs the 
prefix, but unfortunately it doesn't raise an 
exception if you pass an empty string. In- 
stead, it simply neglects to find anything on 
the select. Avoid this problem by using a 
prefix in the namespace both when you add 
it to the XMLNamespaceManager and in 
the select expression. The namespace must 
match your input document, but the prefix 
can be anything as long as it's the same in the 
calls to the AddNamespace and SelectNodes 
methods. This prefix can be unrelated to 
prefixes in your input document. 

Your own utility functions can be ex- 
tremely helpful when you work with XML. 
The two samples in Listing 1 save only a few 
lines of code, but you'll use these and similar 
functions many times in your program- 
ming. Some of these methods, such as the 
GerAttributeOrEmpty method, can help 
you avoid runtime exceptions. This simple 
code raises an exception if the attribute 
doesn't exist: 



node. Attributes. GetNamedltemt _ 
attrName) .Value 
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Public Class Tools 

Public Shared Function LoadVal i dXML( _ 
ByVal xml F1 1 e As Stri ng . _ 
ByVal xsdFile As String, _ 
ByVal nSpace As String) As Xml . Xml Document 
Dim xmlDoc As New Xml . Xml Document 
Dim rdr As Xml . Xml TextReader 
Dim validRdr As Xml . Xml Val i dati ngReader 
Try 

rdr = New Xml . Xml TextReader(xml Fi 1 e) 

val idRdr = New 

Xml .XmlValidatingReader(rdr) 

val i dRdr . Schema s . Add ( n Space , xsdFi 1 e ) 

xml Doc . Load( val idRdr ) 

Return xml Doc 

' Throw 
Fi nal 1 y 

validRdr. CloseO 
End Try 
End Function 

Public Shared Sub MergeRootf _ 
ByVal outDoc As Xml . Xml Node , 
ByVal mergeDoc As Xml . Xml Document ) 
Dim owner As Xml . Xml Document =_ 

outDoc.ChildNodes(O). Owner Document 
MergeNodet owner , outDoc, _ 

mergeDoc.ChildNodes(l), Nothing) 
End Sub 

Private Shared Sub MergeNodet _ 
ByRef owner As Xml . Xml Document , 
ByRef outParent As Xml . Xml Node , 
ByRef node As Xml. Xml Node, 
ByRef nameAttr As Xml . Xml Attn' bute ) 
Dim nsmgr As Xml . Xml NamespaceManager 
Dim idName As String = node. Name & "ID" 
Dim pred As String = "" 
nsmgr = New Xml .Xml NamespaceManagert _ 

owner . NameTabl e ) 
nsmgr. AddNamespace( "zzz" , 

node . NamespaceURI ) 
If Not nameAttr Is Nothing Then 

pred = "[@" & idName & "="' & _ 
nameAttr . Val ue & " ' ] " 
End If 

Dim test As Xml. Xml Node = _ 
outParent . Sel ectSi ngl eNode( 
"zzz:" & node. Name & pred, nsmgr) 

If test Is Nothing Then 
outParent . AppendChi 1 d( 



owner. ImportNode( node , True)) 

Else 

' Node exists, add attributes, then children 
For Each attrib As Xml . Xml Attri bute In _ 
node . Attri butes 

If test. Attributes(attrib. Name) Is _ 
Nothing Then 

test .Attri butes .Append( _ 
Tool s . NewAttri butet _ 
test.OwnerDocument , _ 
attrib. Name, attri b . Val ue) ) 

Else 

test .Attri butest 

attrib. Name) .Val ue = 
attrib. Val uc 
End If 

Next 

For Each childNode As Xml.XmlNode In „ 
node . Chi 1 dNodes 

idName = chi 1 dNode . Name & "ID" 
MergeNodet owner , test, childNode, _ 
childNode.Attributes(idName)) 

Next 
End If 
End Sub 

' Utility Functions follow 

Public Shared Function GetAttri buteOrEmptyt _ 
ByVal node As Xml.XmlNode, 
ByVal attrName As String) As String 
Dim attr As Xml.XmlNode - 

node. Attri butes. Get Named I tem( attrName ) 
If Not attr Is Nothing Then 

Return attr. Value 
Else 

Return "" 
End If 
End Function 

Public Shared Function NewAttri bute( _ 

ByVal xmlDoc As Xml . Xml Document , _ 

ByVal name As String, 

ByVal value As String) 

As Xml . Xml Attri bute 

Dim nodeAttr As Xml . Xml Attri bute 

nodeAttr = xml Doc.CreateAttribute(name) 

nodeAttr. Val ue = value 

Return nodeAttr 
End Function 

End Class 



Listing 1 The Tools class does the work of merging XML files. It validates the XML document based on a schema, performs an intimate 
merge combining elements and attributes, and illustrates the use of utility functions to simplify XML processing. 



The GetAttributesOrEmpty method returns an empty string with- 
out raising an exception. 

You'll run across a variety of processing needs as you encounter 
XML more frequently in the coming months or years. XSLT 
handles many of these well — such as rearranging the structure of 
XML or changing XML to HTML for output. You can handle other 
challenges, such as an intimate merge, more effectively by using 
.NET code and working with XMLDocument objects. VSM 



Kathleen Dollard is an independent consultant doing real-world 
development in .NET technologies. She's currently using XSLT tech- 



niques to generate 450 classes in a 300+ KLOC project. She's active 
in the Denver Visual Studio User Group and is a regular contributor to 
Visual Studio Magazine, a Microsoft MVP, and a VSLive! speaker. 
Reach Kathleen at kathleen@mvps.org. 

Additional Resources 

• Visual Basic .NET and XML by Rod Stephens and Brian 
Hochgurtel [John Wiley & Sons, 2002, ISBN: 0471 12060X] 

• XML Programming by R. Allen Wyke, Sultan Rehman, and 
Brad Leupen [Microsoft Press, 2002, ISBN: 0735611858] 
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Create a Custom Ul 
Value Editor 

Leverage inheritance to add developer-friendly features to a popup button control. 




B' VB.NET 

□ C# 

□ SQL Server 2000 

□ ASP.NET 



□ XML 

□ VB6 



Go Online! 



In last month's Desktop Developer column, I 
showed you a simple approach to building a 
popup button control with inheritance and 
GDI+, and emphasized its ease-of-use features 
for other developers who use the control (see the 
Go Online box). Now, you'll use the same 
control to advance this theme another step — by 
adding a UI value editor to last month's code. 
You'll tap the power of inheritance in .NET 
again, without using any Windows API or black- 
belt techniques. 

The ImageButton control I showed you how 
to design last month uses three different images, 
obtained from an associated .NET ImageList 
control. You gave the ImageButton a design- 
time— only Currentlmagelndex to allow control 
users to cycle through the three images at design 



by Bill Storage 

time. This feature is necessary because Image- 
Index properties have integer values — the ordinal 
position of the related image. The integer value 
isn't particularly friendly at design time if the 
ImageList includes many images; a visual repre- 
sentation of the selected value would be better. 
So, I'll show you how to change the design-time 
display of the Up, Down, and Hoverlmagelndex 
properties to show both the ordinal value and the 
actual ImageList image at that position in the 
Properties browser (download the sample code 
from the VSM Web site; see the Go Online box 
for details). 

This task involves informing VS.NET that 
your Imagelndex properties supply their own 
design-time editor, which appears in the Proper- 
ties browser. In pre-.NET days, this required 
implementinglPerPropertyBrowsing, which was 
essentially impossible in VB. The technique 
you'll use requires no tricks, API calls, or any- 
thing of the sort. 

The first task is to code a means of showing 
all the images from an ImageList in a vertical 
strip when the user selects ImageButton's Up, 
Down, or Hoverlmagelndex in the Properties 
browser. Do this by building a quick ImageBar 
control (see Figure 1). It doesn't need a slick 
programming interface, because you're the only 
person who ever uses the ImageBar directly. 
ImageBar simply draws an array of vertically 
arranged images, along with a number indicat- 
ing each one's position. The drawing technique — 
a few lines of GDI+ in the OnPaint procedure — 
is similar to the one you used in the Image- 



Use these Locator+ codes at www.visualstudiomagazine.com to go directly 
to these related resources. 

Download 

VS0308DT Download the code for this article, which includes the ImageButton control, 
its design-time editor code, and a sample client window. 

Discuss 

VS0308DT_D Discuss this article in the VB.NET forum. 
Read More 

VS0308DT_T Read this article online. 

VS0307DT_T Desktop Developer, "Build a Popup Image Button" by Bill Storage 

VS0206DTT Desktop Developer, "Craft .NET Controls With Inheritance," by Michael 
Welch 

VS0206BS_T "Subclass Controls in .NET" by Bill Storage 
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Figure 1 Display the Ul Value Editor at Design Time. The Image- 
Button control class uses a custom Ul value editor — the Image- 
ButtonEditor class — to ease the selection of an image in an ImageList 
by showing the image along with its index in VS.NET's Properties 
browser. The editor displays a private ImageBar control, which you 
design solely for this purpose, when a user clicks on the dropdown 
arrow for any property specifying ImageButtonEditor as its editor. 

Button itself, without the concern for mouse-button state (see 
Listing 1 ) . ImageBar has a single event — IndexChanged. You must 
supply this event for the Ul value editor, so that the Properties 
dropdown list closes after the user makes an Imagelndex selection. 

You must make one small change to the ImageButton control 
code. You need to add an <Editor> attribute to the Up, Down, and 
Hoverlmagelndex properties to tell .NET that these properties use 
a custom editor. This causes a dropdown to appear for these 
properties in the Properties browser. The Editor constructor takes 
two arguments: your custom editor's type, and the .NET editor type 
from which your editor class derives — UITypeEditor, in this case: 

<Edi tort GetType( ImageButton Ed i tor ) , _ 
GetType(UITypeEditor) ) 

The inheritance introduction/refresher in last month's column 
will serve you here too. Your editor must override two methods of 
the UITypeEditor base class from which your editor derives — 
GetEditStyle and EditValue — in order to cooperate with the Prop- 
erties browser (see Listing 2). This code isn't particularly difficult, 
but you probably haven't seen anything like it yet. The GetEditStyle 
and EditValue procedures you write for this project can serve as a 
template for all future Ul value editors you build. 

Inherit From UITypeEditor 

Start with a new class that inherits from UITypeEditor and imple- 
ments IDisposable. You need project references to the .NET 
ComponentModel and Drawing libraries for this. The GetEditStyle 



VB.NET • Draw the Control the Editor Shows 



Protected Overrides Sub OnPainttByVal e As _ 
System. Wi ndows . Forms .PaintEventArgs) 

Dim g As Graphics = e. Graphics 

Dim r As Rectangle 

Dim 1 , Hgt , Wi d As Integer 

Dim fNormal As New _ 

Font ( FontFami ly. Gene ri cSansSerif. 8) 

Dim fBold As New FonttfNormal , FontStyl e . Bol d ) 

If Not IsNothing(_ImageList) AndAlso Not _ 
_ImageList. Images. Count = Then 



'Draw images and text 
Hgt = _ImageLi st . ImageSi ze . Hei ght 
Wi d = _ImageLi st . ImageSi ze . Wi dth 
For i = To Me ._ImageLi st . Images . Count 
Dim f As Font = fNormal 
If i = _JmageIndex Then f = fBold 
g . DrawStri ngt i .ToStri ng , f, _ 

Brushes. Black, 2. (i * Hgt) + 6) 
g.DrawImage(_ImageList.Images(i), _ 
TextWid + 1. 1 + (i * Hgt). _ 
Wid, Hgt) 

Next 

'Draw selection border 

r = New Rectangle(2, 2 + ( _ 

_lmagelndex * Hgt), TextWid + Wid 

Hgt - 2) 
g.DrawRectanglefPens.Blue, r) 
End If 



2. _ 



r = New RectangleO. 1, Me. Size. Width 

Me. Size. Height - 2) 
g . DrawRectangl e( Pens . Bl ack , r) 
fNormal . Di spose{ ) 
fBold. Disposef ) 
MyBase.OnPaint(e) 
End Sub 



Listing 1 GDI+ makes quick work of displaying all the images in an 
ImageList. You also add text for the image index and draw a basic 
selection rectangle. 

override uses three parameters, two of which require some explana- 
tion. The first — context — is of type ITypeDescriptorContext. At 
design time, the context value holds information about the instance 
of the control being edited and its container. Surprisingly, it also 
contains a PropertyDescriptor — a complete set of descriptive details 
about the property of the control that's being edited. This is 
important for the ImageButton, because three of its properties use 
the same UIEditor, and the editor must know which property it 
should update. The .NET Platform SDK instructs you not to 
depend on the existence of the context object or context.Instance 
when EditValue is called, so your EditValue code must check for 
null values. 

EditValue's second parameter — provider — is of type IService- 
Provider, and in this case is a service provider that implements 
IWindowsFormsEditorService. IServiceProvider has a single 
method — GetService — that returns the service being provided. For 
VS.NET design time, this means the particular property line a user 
has selected in the Properties browser. Again, you must ensure that 
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VB.NET • Display a Ul Value Editor in the Properties Browser 



. 



Public Overloads Overrides Function 
Edi tVal uet ByVal context As 
ITypeDescri ptorContext , ByVal provider As 
IServi ceProvi der . ByVal value As Object) As 
Object 

If (Not (context Is Nothing) And Not 
(context. Instance Is Nothing) And Not 
(provider Is Nothing)) Then 
_EdServi ce = _ 

CType(provider.GetService(GetType( _ 

IWi ndows Forms Ed itorServ'ce)), 

IWirdowsFormsEdi torServi ce) 
If . EdService Is Nothing Then Returr. Nothing 



_ImageBar = New ImageBarO 
AddHandler _I ma geBar. I nd exchanged, 
Me . Val ueChanged 



AddressOf 



'Determine which property is being edited, 
'since several props use this editor 
Dim SourceBtn As ImageButton = _ 



CType( context .Instance, ImageButton) 

'Set properties of the ImageBar displayed by 
'this editor 

_ImageBar. ImageList = SourceBtn . ImageLi st 
Select Case context . PropertyDescri ptor . Name 
Case "Hoverlmagelndex" 
_ImageBar. Lmagelndex = _ 
Sou rceBtn. Hover I irage Index 
Case "Downlmagelndex" 
_ImageBar. lmagelndex = 
SourceBtr. Downlmagelndex 
Case "Uplmagelrdex" 

_ImageBa r . lmagelndex = SourceBtn. Uplmagelndex 
End Select 

_ImageBar. lmagelndex = Clnt(value) 
_EdServi ce.DropDownControl(_I ma geBar) 
Return _ImageBar . lmagelndex 
End If 

End Function 



Listing 2 Overriding the UlTypeEditor base class's EditValue method makes your editor do its work. Be certain that the incoming parameters 
are valid, then set properties of the control for the browser to display. Tell the editor which properties to edit, and give it a listener for the 
display control's PropertyChanged event. 



the GetService return value is valid before 
you proceed. 




his code isn't 
particularly 
difficult but 
you probably 
haven't seen 
anything like 
it yet. 



If all these checks succeed, then you can 
be sure that EditValue's third parameter — 
value — contains the current value of the prop- 
erty being edited. Use this to set the initial 
value-editor displays. If your editor applies 
to multiple properties, as with ImageButton, 
get the current property from context.- 
PropenyDescripcor.Name. Store the return 
value of GetService in a class-level variable 
for when you need to close the Properties 
browser dropdown later. EditValue can use it 



directly to show the dropdown by calling 
IWindowsFormsEditorService.DropDown- 
Control. 

EditValue needs to complete one more 
task. It must provide for the editor to close 
the Properties browser dropdown after the 
user picks an Up, Down, or Hoverlmage- 
lndex value. To do this, the editor needs to 
know when the ImageBar control's Image- 
Index values change. Note this applies to the 
ImageBar displaying an ImageButton's prop- 
erty value, not the ImageButton itself. Get 
this notification by listening to the Image- 
Bar's IndexChanged event — the event you 
wrote for the tiny ImageBar control, solely 
for this purpose. Subscribe to the ImageBar's 
event by providing a callback function — 
ValueChanged — and by using AddHandler: 

AddHandler _ImageBar. IndexChanged, _ 
AddressOf Me . Val ueChanged 

Overriding the GetEditStyle method is 
much easier. You merely tell the editing 
context what to do when a user wants to edit 
a property. If the context and instance are 
valid objects, simply return UITypeEditor- 
EditStyle.DropDown. Modal is also a valid 
style if you need to show a complete separate 
editing window instead of a dropdown, un- 
like the case with ImageButton properties. 

The rest of the ImageButtonEditor class 
consists of two support functions. The pri- 



vate ValueChanged procedure listens to the 
ImageBar's IndexChanged event and closes 
the Properties browser dropdown. Clean up 
your editor by unhooking the ValueChanged 
event listener by implementing IDisposable.- 
Dispose and calling RemoveHandler in it. 

The entire ImageButtonEditor class con- 
tains about 40 lines of executable code, and 
compilingit, the ImageBar, andyouroriginal 
ImageButton class yields a DLL weighing in 
at awhopping 12K — not bad, given the level 
of sophistication you're providing. I'll show 
you in a future article how to build a similar 
ASP.NET image-button control with both 
server- and client-side behavior, vsiw 



Bill Storage is the president of Nerve Net 
Inc., the founding author of VBPJ's Black Belt 
Programming column, and a member of the 
Visual Studio Magazineadvisory board. Reach 
him at bstorage@bstorage.com. 

Additional Resources 

• "Creating Controls": http://samples. 
gotdotnet.com/quickstart/winforms/ 
doc/winformscreatingcontrols.aspx 

• Chapters on inheritance and control 
creation in Professional VB.NET, 2nd 
Edition, by Fred Barwell et al. [Wrox 
Press, 2002, ISBN: 1861007167] 
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Order the Visual Studio CD Rom 

• Full code, simply cut and paste • Fast and easy Acrobat format 
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Manage BLOB 
Data Fields 

AD0.NET and SQL Server let you retrieve random images for display in 
your WinForms apps. 



by Fabio Claudio Ferracchiati and Juval Lowy 
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Manage BLOB Data 
Fields 

I need to develop an application that displays 
random images stored in a Microsoft SQL Server 
database in a picture box. Is there an easy way to 
accomplish this functionality? 

A: 

Yes. ADO.NET and SQL Server give you all the 
tools for retrieving binary large objects (BLOBs) 
easily from a database. You can use a simple 
application I created as a model for implement- 
ing dynamic image changing in a WinForms 
form. Start by examining the database structure: 

CREATE TABLE [dbo] . [T_Image] ( 
[ImagelD] [int] IDENTITY (1, 1) 
NOT NULL , [ImageBinary] [image] NOT 
NULL ) ON [PRIMARY] TEXTIMAGE_ON 
[PRIMARY] 

The table has two columns — an image iden- 
tifier as primary key, and the image's binary 
code. As you can see, SQL Server provides an 
image data type that's useful for managing im- 
ages within a database. This stored procedure 
retrieves the binary image data and provides an 
image identifier: 

CREATE PROCEDURE dbo . Retri evelmage 
@id int 

AS 

SELECT ImageBinary FROM T_Image 
WHERE Imageld = @id 

This stored procedure inserts a new image 
into the database: 

CREATE PROCEDURE dbo . I nsert Image 
81 image 



AS 

INSERT INTO T_Image (ImageBinary) 
VALUES (@i ) 

The code to execute a stored procedure is 
simple, thanks to the ADO.NET classes. You 
call the Insertlmage stored procedure, which 
provides binary code from an image file (see 
Listing 1). 

Calling a stored procedure from the code 
takes six steps. First, create a SqlConnection 
object that specifies the connection string of the 
database to connect. Second, create a Sql- 
Command object; use the new object to specify 
the StoredProcedure command type and the 
CommandText with the stored procedure name. 
Third, add a new Parameters collection item for 
each stored procedure parameter. Fourth, open 
the connection to the database. Fifth, use either 



" ImageDB 
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Figure 1 Retrieve an Image. You can retrieve an 
image from the database and assign it to a pic- 
ture box. You change the image by passing the 
new image's identifier to the stored procedure. 
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f~ VB.NET • Add an Image 



Try 


Dim fs As FileStream 


Dim dbConn As New SqlConnection( ) 


fs = Fi 1 e. OpenRead(<f i 1 emame> ) 


dbConn . Connecti onStri rig = ". . ." 


Dim buffertfs. Length) As Byte 




fs.Read(buffer, 0, fs. Length) 


Dim dbComm As New Sql Command!) 




HHP n mm P nrnm^nHTovt — "rinCQctlmajlQl" 
UULUIMHI.LUHllHdnuieXL LinseiLIIMdycJ 


UULUMNM.rdialMcLcibt Is 1 ■ . V a 1 U C 


dbComm.CommandType = StoredProcedure 


buffer 


dbComm. Connection = dbConn 


dbComm. ExecuteNonQueryf ) 


dbComm. Parameters .Add ( New 




Sql Parameter! "@id". 


Catch ex As Exception 


SqlDbType.Int, 4, 


MessageBox. Show! ex. Message) 


ParameterDirection. Input, _ 


Final ly 


False, CTypeUO, Byte), 


If (dbConn. State = _ 


CTypetO, Byte) , "" , _ 


ConnectionState.Open) Then 


DataRowVersi on . Current , 


dbConn. Closet) 


Nothing) ) 


End If 


dbConn. Open! ) 


End Try 



Listing 1 This code calls the Insertlmage stored procedure in the SQL Server database to add an image as a binary large object (BLOB) item. 
When you use ADO.NET to call a stored procedure, you must specify each of its parameters in the Parameters collection. Finally, you must 
provide the values to insert in the database and call the ExecuteNonQuery method. 



the ExecuteNonQuery method to execute a stored procedure that 
doesn't return a value, or the ExecuteReader method to execute a 
stored procedure that returns a reference to the DataReader object. 
Finally, close the connection. 

As you can see in Listing 1, the FileStream object reads the 
contents of the image file. You create a Byte buffer for containing 
the image content, then pass it to the stored procedure you'll insert 
into the database. 

You must execute the Retrievelmage stored procedure in order 
to retrieve an image from the database and provide the image 
identifier of the image you want to retrieve: 

Try 

dbConn. Open( ) 

dbComm. Parameters ( "@id" ). Val ue = 

<imageid> 
Dim buffer! ) As Byte 
buffer - dbComm. ExecuteScal ar( ) 
Dim s As New MemorySt ream! buff er ) 
s.Writetbuffer, 0, buffer. Length) 
pblmageDB. Image = _ 
Image . FromStrea'm! s ) 
Catch ex As Exception 

MessageBox . Show! ex .Message) 
Finally 

If (dbConn. State = _ 

ConnectionState.Open) Then 
dbConn .CI ose( ) 
End If 
End Try 

After the connection to the database is open, you can provide the 
image's identifier dynamically to retrieve the image from the 
database (see Figure 1). The SqlCommand class's ExecuteScalar 
method executes the SQL instruction in order to retrieve only the 
command's first parameter. This is useful when you execute a SQL 
command that returns only a value (for example, a newly inserted 
record's identifier or a specific image's bytes). Now that the buffer 



contains the stored procedure's result, the code uses a MemoryStream 
object to fill a memory space with the image bytes. This step is 
necessary because the Image class doesn't provide a method that 
reads image bytes. The Image class accepts either a filename or a 
handle to the bitmap, except for a Stream object. So, you change the 
picture box image dynamically by setting its Image object reference 
with the new Image object filled with the image bytes stored in a 
MemoryStream object. — F.C.F. 

C^J Implement Subclassing in 
WinForms Forms 

My application is basically a series of forms. Any number of the 
form's instances can be open at any time. I need to detect when 
another application has taken the focus through either mouse clicks 
or keystrokes, such as Alt+Tab. Is there an easy way to produce this 
effect? I want my program to shut itself down if another application 
takes focus. 

A: 

A WinForms form in the .NET Framework is subjected to the 
Activated event when the user selects it with either the mouse or 
keystrokes. However, this isn't a good event for your application, 
because it's raised when the form in a single document interface 
(SDI) application, or a child form in a multiple document interface 
(MDI) application, is activated — not when the application gets the 
focus from another application. Your only solution is to subclass the 
form (download the sample code from the KSAfWeb site; see the Go 
Online box for details). 

Subclassing is an advanced technique for implementing non- 
standard Windows controls and features. I used it for the first time 
to create a listview control that displays a different color in each row. 
Subclassing lets you retrieve Windows system messages and change 
default behavior against these messages. Implementing subclassing 
in VB.NET is simple. You can override the Control class's WndProc 
methods directly in your form's code. 

Protected Overrides Sub WndProc( 
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ByRef m As Message) 
MyBase.WndProc(m) 

The first instruction you add within the method is the call to the 
base class's method. The Message parameter contains the Msg 
property, which indicates the Windows system message that the 
system fires. You can use a Select Case in the WndProc method to 
manage these messages, and you can find definitions of the mes- 
sages' values in the Windows.h header file. 

Your application must use the WM_ACTIVEAPP message that 
the OS fires when the user selects your application with either a 
mouse click or a keystroke. The WM_ACTIVEAPP Windows 
message fires with the word param set to zero when your application 
becomes inactive. You can check this value in order to close the 
application: 

Select Case m.Msg 

Case WfLACTIVATEAPP 

If m.WParam.ToInt32 = Then 

Appl i cati on . Exi t ( ) 
End If 
End Select 

You force the application to quit by calling the shared Exit method 
that the Application class provides. — F. C.F. 

'l Automate Asynchronous Event 
Publishing 

You show how to publish events asynchronously in your "Tame 
.NET Events" article (KW April 2002; see the Go Online box). I 
need to publish many event types asynchronously. Is there a way to 
automate the process instead of duplicating the code for every 
publisher and delegate? 

A: 

The technique I demonstrated in that article addresses the problem 
of publishing events asynchronously. .NET lets you use the 
BeginlnvokeO delegate method to invoke the delegate target asyn- 
chronously on a thread from the thread pool. The only limitation 
to using BeginlnvokeO is that the delegate must have only a single 
target in it; otherwise, an exception is thrown. Alrhough it's normal 
to have a single target when you use a delegate dedicated to 
asynchronous invocation, you usually end up with multiple sub- 
scribers to events. The previous article's solution was to iterate 
manually over the delegate's internal invocation list and publish to 
every delegate in that list asynchronously (download Listing 2). 

The problem with Listing 2's code is that it isn't generic, and 
you must repeat such code in every case in which you want to 
publish events asynchronously. Fortunately, you can write a generic 
helper class to automate asynchronous event publishing (down- 
load Listing 3 and the sample code). 

You use the param modifier to pass in any collection of argu- 
ments, as well as the delegate containing the subscribers list. The 
FireAsyncO method iterates over the internal collection of the 
passed-in delegate. For each delegate in the list, it uses another 
delegate of type AsyncFire to call the private helper method Invoke- 



DelegateO asynchronously. InvokeDelegate() simply uses the Del- 
egate type's DynamicInvoke() method to invoke the delegate. 

Using EventsHelper to publish events asynchronously is easy, 
compared to Listing 2: 

public delegate void 

NumberChangedEvenU i nt num); 

public class MySource 
I 

public event NumberChangedEvent 
Number-Changed ; 

public void Fi reEventAsynct i nt num) 
( 

Even tsHel per. Fi reAsynct 
Number-Changed, num) ; 

1 



You also decorate EventsHelper's InvokeDelegate method with 
the OneWay attribute, which is defined in the System. Runtime. - 
Remoting.Messaging namespace. .NET doesn't keep track of the 
method invocation when it invokes a one-way method asynchro- 
nously, and it doesn't manage any completion callbacks or record 
exceptions. As a result, dispatching the call asynchronously involves 
no overhead. One-way methods mean semantically that the caller 
shouldn't care what happens after calling the methods. This is 
clearly the case with FireAsyncO, because the EventsHelper's client 
doesn't care about the result of publishing the event asynchronously 
to all the subscribers. — J.L. 



Fabio Claudio Ferracchiati has 1 years of experience using Microsoft 
technologies. He's been focusing attention recently on the new .NET 
Framework architecture and languages and has written books for 
Wrox Press about this technology. He works in Rome for the CPI 
Progetti SpA company (www.cpiprogetti.it). Contact him by e-mail at 
ferracchiati@rocketmail.com. 

Juval Lowy is a software architect and the principal of IDesign, a 
consulting and training company focused on .NET design and .NET 
migration. Juval is Microsoft's regional director for the Silicon Valley, 
working with Microsoft on helpingtheindustryadopt.NET. His portion 
of this article derives from his latest book. Programming .NET Compo- 
nents (O'Reilly & Associates). Juval speaks frequently at software- 
development conferences. Contact him at www.idesign.net. 



Additional Resources 

• Professional ADO. NETby Fabio Claudio Ferracchiati et al. 
[Wrox Press, 2001, ISBN: 186100527X] 

• Programming Microsoft Visual Basic .NET (Core Reference) 
by Francesco Balena [Microsoft Press, 2002, ISBN: 
0735613753] 
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Do You Think In Ink? 

Test your skills! Write Code and Win a Tablet PC 

Microsoft's new Tablet PC introduces new ways to work with technology — and a 
new world of development capabilities. Here's your chance to show off your 
coding skills: just write a cool app using Tablet PC capabilities, and you could 
win one of a pile of Tablet PCs. 

Just visit www.tabletpcdeveloper.com for complete details and to enter the 
contest. Register, upload your code, and you're good to go! Don't miss out! 
Contest ends June 30th. 

You can enter code in three categories: 

Best Source Code 

Source Code Samples can be any kind of source code that shows interesting uses of ink, 
pen, handwriting recognition, or gestures; samples can also show basic functions that can 
be easily reused by other developers. 

Best PowerToy 

PowerToys are small utilities that show off the power of the Tablet PC platform leveraging 
ink, handwriting recognition, gestures, or pen-centric user interfaces. PowerToys can also be 
small utilities that integrate ink, handwriting recognition, gestures, and pen control into the 
Windows shell. Entries must include the compiled executable as well as the source code. 

Best Component 

Components include compiled, reusable components that can easily be used by developers in 
other applications. Source code does not need to be submitted with the component, but 
there needs to be sufficient documentation that the use of the component is clear. 




Doe&Your Code. Q 



Submit a Code Sample in one of the three categories to enter to win a free Tablet PC! You may ' 
enter as many samples as you want, but each sample can only be entered into one category. Every 
entrant that submits code and completes the address submission tool will receive a free Tablet PC 
baseball cap (one hat per person; see Web site for details and restrictions). Judges from Visual Studio Magazine 
and Pen Computing Magazine will evaluate all entries, and designate one winner for each category every month starting 
March 3, 2003 and ending June 30, 2003. One Tablet PC will be awarded in each category every month to the developer 
of the best Source Code Sample, PowerToy, and Component. For complete contest details, visit 
http://www.tabletpcdeveloper.com/content/contest/rules.aspx. 

Visit www.tabletpcdeveloper.com today! 



Enable Customer 
Reviews 



Create a custom control that adds reviewing and rating functionality to 
e-commerce sites. 
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P: 



"opular e-commerce sites, such as Amazon 
and eBay, allow users to review and com- 
ment on products available for sale on the site. 
This functionality lets customers consider im- 
partial comments when they choose among 
products, and helps sellers understand customer 
preferences. I'll show you how to implement 
your own reviewing functionality by using a 
powerful technique you can reuse on any page — 
the ASP.NET custom control. 

An ASP.NET custom control is an assembly 
that contains one or more classes that derive 
from the WebControl class in the System.- 
Web.UI.WebControls namespace. Creating an 
ASP.NET custom control is similar to building 
a WinForms control: You can use the overridable 
Render method to provide a user interface and 
to display graphics. You can build the HTML 
representing your control's output in the Ren- 
der method's body and use the HtmlText Writer 
method's parameter to write the HTML into the 
ASP.NET page. You can also 
specify new properties and use 
VB.NET language attributes to 
specify default values, descrip- 
tions, VS.NET Properties win- 
dow categories, and much more. 

When a page containing the 
custom control loads, the con- 
trol receives many sequential 
events you can trap to customize 
the component's behavior (see 
Table 1). You usually use the Init 
event to initialize the control's 
member variables and the Ren- 



by Fabio Claudio Ferracchiati 

der event to write the HTML code into the 
ASP.NET page. You can implement IPostBack- 
DataHandler and IPostBackEventHandler in- 
terfaces for your component class to add extra 
events, such as LoadPostData, which retrieves 
incoming form data so you can manage it before 
the control uses it. 

Now I'll show you how to build the Re- 
viewerCtrl custom control to add review func- 
tionality to your pages (download the source 
code from the VSM Web site; see the Go Online 
box for details). ReviewerCtrl comprises three 
classes. The AverageCtrl class, which derives 
from the WebControl class, displays an image 
representing the product's ratings average. The 
ListCtrl class, which also derives from the Web- 
Control class, displays an HTML table contain- 
ing either the last user comment or a list of all 
comments related to the specified product iden- 
tifier. The Vote class, which derives from the 
Object class, provides the InsertReview method, 
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Figure 1 View Averages and Reviews. This ASP.NET page dis- 
plays the AverageCtrl and the ListReviews components. The 
ListReview property is set to show only the last review. 
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which allows you to associate a new review 
to the related product. 

All three classes have two common prop- 
erties: The ProductID property specifies the 
product identifier you use to associate rat- 
ings and reviews to the product, and the 
XMLPath property specifies the path of the 
XML files where you store ratings and re- 
views. You could use a database to store 
them, but XML — in conjunction with 
ADO.NET classes — is the best solution 
when you have a small amount of informa- 
tion to manage, because you don't waste 
resources by connecting to a database, and 
you're ready to share your data through 
Web services. 

Change the Tagname 
Value 

The <ccl :tagname> tag is used by default 
when you insert the ReviewerCtrl compo- 
nent into an ASP.NET Web form. You can 
change this value by adding the TagPrefix 
Attribute class to specify the component 
namespace and the new prefix: 

<Assembly: TagPref i x ( " Revi ewerCt rl " , _ 
"VSM")> 

You can also associate a new icon to a 
custom control by adding a 1 6-by- 1 6 bitmap 
that has the same control class name and the 
Embedded Resource property. The control 
uses the new bitmap instead of the default 
one when you add the component to 
VS.NET's toolbox. 

Take a look at each component the 
ReviewerCtrl assembly provides, starting 
with the ListReviews control. This compo- 
nent displays either an HTML table filled 
with all the reviews for the specified prod- 
uct, or the last review (see Figure 1). The 
component provides this property in order 
to know which kind of output to display in 
the final ASP.NET page: 

<Bindable(True), 

Categoryt "Appearance" ) . 

Defaul tVal net "True" )> 

Property LastReviewO As Boolean 

Get 

Return m„bLastRevi ew 
End Get 

SettByVal Value As Boolean) 

rrubLastRevi ew - Value 
End Set 
End Property 



The Attribute classes you specify j ust before 
the property are useful for customizing the 
component's look and feel within VS.NET 
(see Table 2). 

The component checks during the Ren- 
der phase for the LastReview property in 



order to display the correct output (see 
Listing 1). You build a temporary string to 
concatenate the XMLPath and the product 
identifier and obtain the XML file associ- 
ated with the product. Then, you use the 
ReadXml method to load the XML file into 



Event 



Description 



Init 

LoadViewState 
Load 

PreRender 
SaveViewState 

Render 
Dispose 

Unload 



You can use the Onlnit method to trap this event and initialize member 
variables and other values. 

You can trap this event to customize how the control retrieves 
information from the ASP.NET hidden ViewState field. 

This event is raised after you create and initialize the control. This is 
the best place to make the connection to the database or load 
document content. You can trap the Load event by adding the OnLoad 
method to the class. 

This event is raised before ASP.NET renders the control. Any changes 
to the control's state are saved into the hidden ViewState field. 

This event is raised before the control state is persisted into the 
hidden ViewState field. You can trap the event to customize how this 
information is stored. 

You can use the Render method to respond to this event and specify 
the HTML code that represents the component's content. 

This event is useful for cleanup operations. It's raised before the 
control is torn down and is the best place to free the resources created 
during the load phase. 

This event is raised before the control is torn down. The official 
documentation says not to use this event to perform cleanup, and to 
rely on the Dispose event instead. 



Table 1 Trap Events to Customize Behavior. You can trap these events to customize an 
ASP.NET custom control's behavior. The Render method, which lets you add HTML code to 
build your control, is especially useful. 



Event 



Description 



<Rindable> 



<Browsable> 



<DefaultValue> 



<Description> 



<ParenthesizePropertyName()> 



This is a Boolean value indicating whether you can bind 
the property to a data source (True) or not (False). By 
default, the property isn't inserted into the DataBindings 
dialog box (False). 

This is a Boolean value indicating whether the property 
must appear in the Properties window (True) or not (False). 
True is the default. 

You can use this attribute to specify a default value in the 
Properties window. 

You can use this attribute to associate a description to the 
property. The description appears in the Properties window. 

You can use this attribute to add parentheses to the 
property name (for example, the ID property) by using 
the Boolean True value, or to display it without 
parentheses (False). 



Table 2 Adjust Design-Time Control Attributes. You can use these attributes to customize 



your component's look and feel v 



T. For example, the <Description> attribute lets 



you describe the component's properties in VS.NET's Properties window. 
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a strongly typed DataSet. Finally, you use the DataView object's 
Sort property to sort the DataSet content so that the first record 
corresponds to the last inserted review. If the LastReview property 
is set to False, a For Each loop uses the DataSet to display each 
record. 

VB.NET • Display Product Reviews 



If ProductID > Then 

If m_strXMLPath.EndsWith("\") =_ 
False Then 

strXMLPath = m_strXMLPath & "\" 
& m_l ProductID. ToString( ) & _ 
" I'xrtrT" 

Else 

strXMLPath = m_strXMLPath 8 _ 
m_l ProductID. ToStringO & ".xml' 
End If 

m„dsRevi ews . ReadXml (strXMLPath ) 
If m_bLastReview = True Then 
rn_dsReviews.REVIEW.DefaultView. 

Sort - "ID_REVIEW DESC" 
Dim dv As DataRowView = _ 

m_dsReviews.REVIEW.DefaultView(0) 



Listing 1 This portion of ListReviews' Render method prepares the 
HTML code to display either a table with every review for the speci- 
fied product or only the last review. 
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The Render method provides the HtmlText Writer parameter, 
which contains the Write method. This method writes the specified 
string as HTML output in the ASP.NET page. 

The AverageCtrl component calculates the average of all prod- 
ucts' ratings by summing all ratings and dividing by the number of 
ratings, then shows the related HTML <IMG> image tag (see 
Figure 1). It adds the new number to a new DataSet column and 
uses it in a Select Case statement to pick the correct image. You use 
the Init event to create the new column, specifying the Double data 
type in order to manage decimal numbers: 

Protected Overrides Sub OnlniU 
ByVal e As System. EventArgs ) 

Dim dc As New DataCol umn( "Average" , 
System. Type. GetTypet _ 
"System. Double" ) ) 

m_ds Re v iews. REV I EW. Columns. Add (dc) 

Sum and Average the Ratings 

You use the Sum aggregate function in the Render event to sum all 
the ratings and calculare the average: 

Protected Overrides Sub Rendert _ 
ByVal output As Html TextWri ter ) 

m_dsReviews.ReadXml (strXMLPath) 

m_dsReviews. REVIEW. 

Col umns( "Average" ). Expressi on <= Sum(Vote)" 
Dim dAverage As Decimal = 

m_dsReviews.REVIEW(0) 

("Average") / _ 

m_ds Rev iews. REVIEW. Count 




Vote 



Your Review: 



Author: 



Read All Comments 

<* Excellent 
<~ Very Good 
CGood 
C Sufficient 
C Not sufficient 

Vote! I 



_J 



Figure 2 Add a New Review. The InsertReview.aspx page uses the 
Vote class to add a new review for the specified product. Once the 
user clicks on the Vote button, the code calls the InsertReview 
method, which provides the content of Web form fields. 
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Finally, you round the average by a decimal place and use the 
resulting value to build the image name: 

Select Case ( Decimal . Round(dAverage , 1)) 
Case 1.0 

strlmage = strPrefix & "l.gif" 

The control provides output types for book content sites, music 
content sites, and generic content sites. The control's Type property 
lets users select the output type by choosing from an Enum data type 
(download Listing 2). 

The ReviewerCtrl component contains a class you can use to 
insert a new review, either by adding it to the existing XML product 
file or by creating a new one. The class provides the InsertReview 
method, which accepts three parameters: the author name, the 
review content, and the rating (download Listing 3). The method 
uses the product identifier and the XMLPath to build the XML 
filename. It provides the name to the constructor of the Filelnfo 
class within the System. IO namespace. Filelnfo contains the Exists 
method, which checks for the specified file's presence on the drive 
and returns a Boolean True value when the file is found. The 
component then opens the file, retrieves the last product identifier, 
and increments it by one. Finally, it adds a new row to the DataSet 
and uses the DataSet's WriteXML method to write the file. 

An ASP.NET form uses the Vote class to insert a new review (see 
Figure 2). The code behind the Vote button is simple: 

Dim vote As New Revi ewerCt rl . Vote 
vote . ProductID = 1 
vote. XMLPath = "C:\" 

vote. InsertReviewUxtAuthor.Text, _ 

txtReview.Text, _ 

rblVotes.Selectedltem.Value) 
Response. Redi rect( "def aul t . aspx" ) 

The preceding code creates a new Vote object and initializes it with 
a product identifier and XMLPath values. Then, it calls the Insert- 
Review method to pass the parameters retrieved from the Web form. 
Finally, it shows the main page to display the last review inserted. 

You can use ReviewerCtrl with your ASP.NET site simply by 
adding the assembly to the BIN directory and adding the compo- 
nent to VS.NET's toolbox. Leverage ASP.NET custom controls' 
reusability to add high-end features to your pages easily. 



Fabio Claudio Ferracchiati has 1 years of experience using Microsoft 
technologies. He's been focusing attention recently on the new .NET 
Framework architecture and languages and has written books for 
Wrox Press about this technology. He works in Rome for the CPI 
Progetti SpA company (www.cpiprogetti.it). Reach him by e-mail at 
ferracchiati@rocketmail.com. 



Additional Resources 

ASP.NET Components Toolkitby Fabio Claudio Ferracchiati et 
al. [Wrox, 2002, ISBN: 1861008023] 
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Choose the appropriate level of protection to prevent update anomalies. 



Technology Toolbox 



obTvb.net 

□ C# 

j SQL Server 2000 

□ ASP.NET 

□ XML 

□ VB6 

Go Online! 



A 



Use these Locator+ codes at 
www.visualstudiomagazine.com 

to go directly to these related 
resources. 

Download 

VS0308DD Download the code for 
this article, which includes 
examples of using the AD0.NET 
DataSet and optimistic 
concurrency. 

Discuss 

VS0308DD_D Discuss this article in 
the AD0.NET forum. 

Read More 

VS0308DD_T R ea d this article 
online. It includes Listing A. 

VS0304DE_T "Follow the Top 10 
AD0.NET Tips" by Dino Esposito 

VS0206DD_T Database Design, 
"Create More Efficient Database 
Code," by Dino Esposito 

VSEP030228AN_T "Use DataReader 
or DataSet?" by Jonathan Goodyear 



database must serve up to tens of thou- 
sands users simultaneously while pre- 
senting a facade to each user that he or she is the 
only one accessing the database. SQL Server, 
DB2, and Sybase maintain this facade by locking 
data when one user updates it, making all other 
users wait until the original user is finished before 
they can "see" the data. Oracle maintains the 
single-user facade by versioning the data — that 
is, allowing the user to see a consistent view of it 
as of a specific point in time. Whether your 
database uses locking or versioning, serving mul- 
tiple users as though each one owns the database 
can raise concurrency issues — most often when 
more than one user tries to read and update the 
same row at approximately the same time. I'll 
explain the options you have for using the DataSet 
class in VB.NET to avoid these 
problems in your applications. 

You must decide what your 
app will do when a user checks a 
row out of the database to view 
and possibly update it. The row 
might change between the time 
the user checks it out and the 
time he or she completes the up- 
date. If you simply overwrite the 
row in the database when the user 
clicks on the Update button, up- 
dates that other users made in the 
meantime will be lost. Take the 
simple example of multiuser ac- 
cess to a variable (see Figure 1). 
User A retrieves the value of the 
variable X and sees that it's 0. In 



by Bob Beauchemin 

the meantime, User B changes the value to 3. 
When User A adds 1 to the variable's supposed 
value of and writes it back to the variable, the 
variable's value is 1 . However, if User B's changes 
were taken into consideration, the value would 
be 4. User B has lost his update. This is known 
as "last writer wins." Imagine how simple it 
would be for your bank account to get out of 
balance if it worked like this. 

You can use concurrency checking to protect 
against lost updates and other update anomalies. 
The two main types of concurrency checking are 
optimistic concurrency and pessimistic con- 
currency. Pessimistic concurrency ties locks in 
the database to user input: You lock the rows 
when you fetch them. You don't implement 
optimistic concurrency by locking rows. Instead, 



User A 



TEMP = X 



User B 







X = 3 



X = TEMP + 1 



Figure 1 Last Writer Wins. User A thinks he's adding 1 to the 
value of a counter. User B has made changes in the meantime, 
so user A ends up overwriting user B's changes. This is known as 
"last writer wins." 
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VB.NET • Use a Timestamp Column to Implement Optimistic Concurrency 



' Using a timestamp to construct an update command 
Sub UpdateWithTimestampt ) 
Dim connstr as String 

connstr = "server=mysvr :database=mydb : " 
connstr += "integrated securi ty=sspi " 
Dim da As New Sql DataAdapter( _ 

"select * from simple_with_ts" , conn) 
Dim ds As New DataSett ) 
d a . F i 1 1 ( d s , " s i mp 1 e_w i t h_t s " ) 
ds .Tabl es (0 ) . Rows( ) ( 1 ) = "newname" 
ds.Tables(0).Rows(0)(2) = 50 
' generate update command for all columns 
' check concurency by timestamp 
Dim updatecmd = New SqlCommandO 
updatecmd . Connecti on - da . Sel ectCommand .Connecti on 
updatecmd . CommandText = _ 

"update simple_with_ts set " & _ 

"name = Onewname. " & _ 

"age = Onewage " & 

"where simpleid = @ol did and ts - @oldts" 
' add params 

Dim parms(4) As SqlParameter 
parms(O) = New Sql Parameter( _ 

"@newname", Sql DbType . VarChar , 20) 
parms(l) - New Sql Parametert _ 

"@newage", Sql DbType . Int ) 



parms(2) = New Sql Parameter( _ 

"@oldid", SqlDbType.Int) 
parms(3) = New Sql Parametert _ 

"@oldts", SqlDbType. Binary) 
Dim i As Integer 
For i - To 3 

updatecmd. Parameters .Add (pa rms( i ) ) 
Next i 

For i = To 1 

parms( i ) . SourceVersi on = _ 

DataRowVersi on. Current 
parms( i ) . SourceCol umn = „ 
ds.Tables(O) .Columns(_ 
i + 1 ) .Col umnNamet ) 
Next i 

' we want original column for key and 
' timestamp 

parms(2) . SourceVersi on = _ 

DataRowVersi on .Or igi nal 
parms( 2) . SourceCol umn = "simpleid" 
parms(3) . SourceVersi on = _ 

DataRowVersi on . Ori gi nal 
parms( 3) . SourceCol umn = "ts" 
da . UpdateCommand = updatecmd 
da . Update (ds , "simpl e_wi th_ts" ) 



End Sub 




Listing 1 Using a timestamp column lets you use a simpler SQL UPDATE statement than comparing all the columns to their original values. 
This code implements a timestamp-based update. 



you fetch rows initially without taking locks, then check during the 
update to see if the rows are still unchanged. You're optimistic that 
no one else will update a row while your user views it. You can 
implement various degrees of optimism in the way you construct the 
UPDATE statement. 

The DataSet class is one of .NET's vehicles for fetching rows for 
presentation and updating in user interfaces. The DataSet can hold 
one or more sets of rows. You can use a class called a DataAdapter 
to populate the DataSet with data from the database. DataAdapter.Fill 
fills a single DataTable in the DataSet with rows from a SQL 
statement. The user can peruse the rows, update some or all of the 
data, and push the updates back to the database. You use the 
DataAdapter. Update method call to let the user update the data- 
base. The connection to the database is usually open only for the 
short time that Fill and Update execute; the rest of the time, the data 
in the DataSet is disjoint from the data in the database. Concurrency 
problems can occur when you update through the DataSet, but you 
can address them by using optimistic or pessimistic concurrency. 

Avoid Pessimistic Concurrency 

Tying database locks to user input isn't useful. If an application locks 
a row while the user is looking at it, and that user goes to lunch, all 
other users who want to update the data must wait. However, you can 
implement pessimistic concurrency with the DataSet, because you 
can open the DataAdapter 's connection and issue a statement that 
locks the database row. If the connection is opened before Data- 
Adapter.Fill is called, the connection remains open after Fill com- 
pletes and — although you aren't accessing rows through the data- 
base — you can keep them locked (download Listing A from the VSM 
Web site; see the Go Online box for details). However, don't use the 



code in Listing A without an exceptionally good reason, because 
pessimistic concurrency can drive performance down immensely. 

You implement optimistic concurrency by using Fill's default 
behavior, which closes the connection after the DataSet is popu- 
lated. You can check to see if the data has changed when you issue 
the database UPDATE statement (which occurs during Data- 
Adapter. Update). If another user has changed the data, your update 
fails; if the data is unchanged, the update succeeds. For example, 
define a table called simple: 

CREATE TABtE simple ( 

simpleid int primary key, 
name varchar(20) not null, 
age int not nul 1 ) 

Use the DataAdapter to pull the data into the DataSet: 

Dim connstr as String 

connstr - "server=mysvr; database=mydb ; " \ 
connstr += "integrated securi ty=sspi " 
Dim da as New Sql DataAdapter( _ 
"select * from simple", connstr) 

Use this SQL statement when you call SqlDataAdapter.Update: 

name changed from 'oldname' to 'newname' 
-- age changed from 49 to 50 for ID 42 
UPDATE simple 

SET name = 'newname', age = 50 

WHERE simpleid = 42 
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AND name = 'oldname' 
AND age - 49 

You code the preceding SQL statement as the CommandText 
property of the SqlDataAdapter.UpdateCommand property. 

The DataSet helps out with the process, because it keeps track of 
multiple versions of rows that have been updated. You can use 
parameters to set the CommandText property of DataAdapter's 
UpdateCommand. The SqlParameter class contains a property, 
called Row Version, that tells the DataSet which version of the value 
to use. The DataAdapter judges whether the update worked by 
seeing whether the UPDATE statement affects zero or a non-zero 
number of rows. If someone else has changed either name or age (or 
deleted the row), the UPDATE returns "0 rows affected." If no one 
else touched the row (that is, your optimism was justified), you 
receive "1 row affected." 

I'll explain degrees of optimism now that you understand the 
general idea of optimistic concurrency. You can choose from three 
optimism policies. The first policy is to check that the row hasn't 
been deleted. If the row still exists, update it. This is extremely 
optimistic and will cause lost updates if someone else has updated 
the rows. The second policy is to check that the columns you've 
changed have stayed the same, but not worry about the rest of the 
columns and update only the columns you've changed. This policy 
isn't quite as optimistic and won't overwrite others' changes, on a 
per-column basis. 

The third policy option is to check that none of the columns has 
changed, including columns you've updated and ones you've left 
alone. This is the least optimistic approach; the update has more 
chances to fail. You can implement this policy in two ways: Either 
check each column or, if the table contains a SQL Server timestamp 
(aka, a row version — the timestamp changes when anyone updates 
the row), you can check the timestamp (see Listing 1). In any of the 
cases where you check old values against new values, you must also 
include code to check if the row has changed from the database NULL 
value, because you must use IS (rather than "=") when checking for 
NULL. This makes the update statement even more unwieldy. 

Implement Degrees of Optimism 

You implement different degrees of optimism in the way you phrase 
the SQL UPDATE statement (download the sample code). In 
ADO.NET, you have complete freedom over your implementation's 
details when you use the DataAdapter. You can use any text you 
want in the DataAdapter's UpdateCommand. You can even use a 
stored procedure instead of a SQL statement. The code in Listing 1 
implements timestamp-based updates, based on the addition of a 
timestamp column, named ts, to your simple table. 

The first and third policies are fairly easy to implement. The 
second one (update only changed columns) is a bit more difficult. 
When you call DataAdapter. Update, the statement you've coded is 
issued once for each row that's been updated. If the user updates only 
the name field in one row and only the age field in the other row, you 
need two different UPDATE statements. However, the DataAdapter 
doesn't allow you to change the statement directly in between rows. 
Luckily, it provides an event you can hook into, called the 
RowChanging event. This event lets you morph the SQL statement. 
Your event handler for this event checks to see whether an insert, 
update, or delete is taking place. You care only about updates. Then, 



it runs through the current row's DataColumns collection. You can 
determine if each column has changed by comparing the column's 
OriginalValue and CurrentValue. The event handler then either 
reconstructs the SQL UPDATE from scratch or uses string manipu- 
lation to change it to care only about the non-key columns that have 
changed. Finally, it passes the changed SQL statement to the 
database. The sample code includes an implementation that uses 
string manipulation through the .NET regular expression library to 
update only the columns that have changed. 

Even though you can construct your own UPDATE statement 
or stored procedure easily to implement concurrency however you 
like, you might prefer the object model or the development environ- 
ment to provide the statement for you. If your original SQL 
SELECT statement is exceedingly simple — it can't contain col- 
umns from more than one table — you can either use the ADO.NET 
CommandBuilder to build a command for you, or VS.NET's data 
tools. The CommandBuilder in Microsoft's SqlClient, OracleClient, 
Odbc, and OleDb data providers works by simply hooking into the 
RowUpdating event. The first time you call the event, the Command- 
Builder makes a trip to the database to obtain additional metadata 
about the original SELECT statement, and uses parsing to construct 
corresponding INSERT, UPDATE, and DELETE statements. 
Other providers work differently and might not need to make a trip 
to the database. 

Another work-free way to construct UPDATE statements is to 
use VS.NET's DataAdapter Wizard. The wizard constructs simple 
UPDATE statements, lets you use existing stored procedures, and 
even gives you an "optimistic concurrency" choice in the Advanced 
options dialog. If you leave the optimistic concurrency checkbox 
checked, the UPDATE statement is phrased so that each column is 
checked. Each column must be the same as its original value. If you 
uncheck the optimistic concurrency checkbox, the UPDATE state- 
ment updates the row (replacing all columns) if the row's key is 
unchanged. This is the "last writer wins" scenario. The sample code 
includes a shell WinForms application that illustrates both the 
checked and unchecked choices. 

Determining which type of optimistic concurrency is right for you 
depends on the number of users updating the table at the same time. 
If you know there's a single updater — for example, if it's a lookup table 
only the DBA or a specific user updates — extreme optimism is 
warranted, and checking the key will probably suffice. If the database 
is highly dynamic, you probably need to use the timestamp method 
or check every column. With ADO.NET, the concurrency mecha- 
nism you choose is just an UPDATE statement away, vsm 



Bob Beauchemin is an instructor, course author, and database 
curriculum course liaison for DevelopMentor (www.develop.com). 
Bob is the author of Essential ADO.NET (Addison-Wesley) and a 
speaker at VSLive ! and other conferences. He has more than 25 years' 
experience as an architect, programmer, and administrator for data- 
centric distributed systems. Reach him at bobb@develop.com. 

Additional Resources 

Chapter 5 of Essential ADO. NETby Bob Beauchemin [Addison- 
Wesley, 2002, ISBN: 0201758660] 
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Guest Opinion 



Microsoft Should Tout the 
Compact Framework 



The .NET Compact Framework is the best thing to happen 
to mobile devices on a Microsoft platform since, well, ever. 
But at the very moment Microsoft has delivered a tool that 
is leaps and bounds better than anything it has delivered previ- 
ously, it seems in danger of taking its own success for granted. 
For example, this year's Tech^Ed, one of Microsoft's two shows 
of shows for developers, scarcely featured any Compact Frame- 
work sessions at all — a huge oversight and missed opportunity 
for promoting this fledgling platform. 

First, the background: There's been a tremendous gap be- 
tween the tools for your regular, everyday Joe programmer, and 
for those of us who have been working on developing applica- 
tions for handheld devices during the last few years. Handheld 
developers simply lacked the quality tools that everyone else 
used. Initially, an add-on for Visual Basic 6 let you write code 
targeted for mobile devices. Then Microsoft gave us eMbedded 
Visual Tools with a standalone IDE that didn't require you to 
share the VB6 one. This had problems too. When you used the 
IDE to write an application in VB, you were actually writing 
with a scripting language in which everything was a Variant. 
(Thank goodness this problem didn't exist with eMbedded Vi- 
sual C++.) Once an application was in progress, the IDE was so 
buggy that debugging the app was more than painful and ex- 
tremely tedious. 

On the hardware side, a dizzying array of devices made it hard 
to decide which was the best for you and even to know which ones 
your customer might have on site. Even when you did know, it 
was hard to target a device with the correct version of the software. 
Between the programming challenges and the confusing profusion 
of devices, getting an organization up to speed to develop and dis- 
tribute a mobile application was too much work. 

If a vendor wants to grow a market, it must make that market 
easier to enter. Microsoft has done this with the Compact 
Framework. Now anyone who uses Visual Studio .NET 2003 
has the tools to develop applications for Windows CE devices, 
especially Pocket PC applications. You simply select the "Smart 
Device Extension" item from the New Project Templates listing 
to create a new application for the Pocket PC. You can use the 
full power ofVB.NET and C# to write mobile applications. De- 
veloping apps for handheld devices has become a much more en- 
joyable task than in years past. 

Microsoft had to cut back somewhat to get the .NET 
Framework's 30 MB runtime down to 1 .3 MB on the device, 
thereby reducing some of the framework's scope. Microsoft re- 
moved any redundancy that might have existed in overloaded 
methods in order to reduce the runtime's size. You can usually 
recover any functionality that was removed by doing a P/Invoke 



call into the underlying Windows 
API. However, Microsoft did an 
excellent job of retaining func- 
tionality, and the differences be- 
tween the desktop framework 
and the CF are almost invisible. 

Any developer can use the CF 
included in the shipping version 
ofVS.NET 2003 to create mo- 
bile applications with ease. You'd 
think I'd be happy. I should be. 
But I think Microsoft is in dan- 
ger of giving away many of the 
advantages it's worked so hard to 
achieve in mobile platforms. The 
problem: Microsoft is doing a 
poor job of publicizing and mar- 
keting the newfound power of 
this platform. The company of- 
fers the Mobile2Market program 
and the Mobile Solutions Partner 
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Program, but it must hit develop 
ers at the education and conference level to get them and their 
managers to embrace this new market space. Technical confer- 
ences seem to shun sessions on Pocket PCs and the CF. 
Microsoft doesn't run all the conferences around the world, but 
it does have some editorial input into what many include. And 
Microsoft does have control over Tech'Ed, but the conference in- 
cluded a pitifully small number of sessions about the CF. Out of 
more than 350 sessions, only four in the mobility track covered 
the CF, and only two in the data-management track covered 
SQL Server CE (SQL CE). Only one of the more than 30 hands- 
on labs was about SQL CE. This isn't enough coverage to push 
such a great technology to the developer base. Microsoft has 
given us a great tool, but it would be a grave error to assume the 
power of the tool alone will ensure the platform's success. Here's 
hoping the Professional Developers Conference larer this year 
corrects this imbalance. 



Dan Fergus is the chief architect at Forest Software Group, develop- 
ing .NET applications, including Pocket PC applications for sports 
teams. He is a frequent speaker at major technical conferences and 
works as a consultant and trainer, teaching the Compact Framework 
along with Visual Basic .NET and ASP.NET courses. Dan has been 
working with .NET and the CF since the beginning. He is the coauthor 
of The Definitive Guide to the .NET Compact Framework (Apress). 
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Accept No Excuses - Accept No Compromises 
Announcing the XtraGrid Suite v2 from DeveloperExpress 



You can finally breah the MET Grid barrier with the XtraGrid Suite v2, 
specifically designed to help you create feature rich MET applications that will 
blow away your competition. . \Nithout writing a single line of code. . Guaranteed! 



The XtraGrid Suite set the standard as the very first 
component of its kind commercially released for Visual 
Studio® .NET. Developer Express was also the first vendor in 
the industry to offer FULL source code for all of its .NET controls. 

With XtraGrid 2, we have raised the bar with new capabilities, 
a massive feature set and uncompromising flexibility. Quite 
simply, there is nothing on the market today that can stack 
up with the XtraGrid Suite. We are so confident about its 
ground-breaking power, we back it with a 60 day NO 
QUESTIONS ASKED MONEY BACK GUARANTEE. Features 
include: 

■ Advanced Banded and Fixed Column support 

■ Automatic Data Grouping with Joined Group capabilities 
against an unlimited number of columns 

■ Automatic Data Sorting against an unlimited number of 
columns 

■ True Master/Detail Support with Multiple Detail Siblings 

■ Automatic Data Summaries (at all Grid Levels) with superior 
Data Mining options 

■ Multiple Paint Styles including WinXP and numerous 
hybrids 

■ Proprietary Look & Feel Technology for advanced GUI 
requirements 

■ Runtime Column Customization 

■ Built-in Auto Preview and runtime Row Resizing 

■ View Based Architecture, includes both a traditional grid 
and CardView 

■ Built in Data Navigator for use standalone or embedded 
within the XtraGrid 

■ Incremental Search within Grid columns 
m Export to MS Excel® and HTML 

■ Gradient and AlphaBlending support along with 
CustomDraw for all grid elements 

■ 18 resource friendly and lightweight Data Editors, available 
for grid editing or use outside of the XtraGrid. 

■ Ms Excel® Style Data Filtering 

■ Full Graphics/Image support within grid and card views 

■ Bound and Unbound Mode - with full support of ADO.NET 

■ New Item Row and built-in Runtime Menus just like MS 
Outlook® 

■ And so much more... 

To learn more about the XtraGrid Suite v2 and compare it to 
your existing .NET grid control or to download a full evaluation 
copy, please visit: www.devexpress.com/xtragrid 

Competitive Upgrade Pricing - We know many of you may 
have already spent money on a .NET Grid control. We are so 
confident in the XtraGrid Suite, that not only do we back it 
with a 60 day unconditional money back guarantee, but we 
also offer significant competitive upgrade discounts. Visit 
www.devexpress.com/discounts today and make the move 
to the FEATURE COMPLETE Grid control by Developer Express 
Inc. 




www.devexpre5s.com 
(888) GoDevex 
(702) 262-0609 
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